isolated-birdhouse-web-testing

What problem does it solve? Running browser-based tests against a Birdhouse feature branch risks port collisions, interference with other worktrees, and lost test artifacts. This Skill provides a structured workflow for spinning up disposable, isolated Birdhouse instances from a worktree and delegating browser validation to child agents. ## Core Features & Use Cases - Isolated Port Management: Claims a dedicated 20-port block per run using git-common-dir locks so parallel worktrees never collide. - Disposable Run Environments: Starts a detached Birdhouse server with a timestamped run directory containing workspace, screenshots, logs, and a database. - Child Agent Delegation: Teaches parent agents to hand off browser testing to reusable child agents that capture screenshots and MP4 recordings and report classified findings. - Use Case: You are verifying a feature branch against a new OpenCode version. Use this Skill to claim ports, launch an isolated instance from your worktree, delegate the browser validation to a child agent, and keep the full run directory for review until cleanup is approved. ## Quick Start Ask the agent to set up isolated Birdhouse web testing for the current worktree and delegate browser validation of a specific user flow to a child agent.