SOP for debugging browser automation failures on complex websites. Use when browser tools fail on specific sites like LinkedIn, Twitter/X, SPAs, or sites with Shadow DOM.
queen-colony-debug
queen-colony-debug is an open-source workflow skill for Claude Code and compatible agents, published by aden-hive. It packages reusable instructions an agent loads on demand to help with workflow tasks. The project has 11k stars on GitHub and is available under the Apache-2.0 license. Add it to your setup with `git clone https://github.com/aden-hive/hive ~/.claude/skills/queen-colony-debug`.
What queen-colony-debug does
SOP for live debugging of queen sessions, colony forks, worker spawns, and tracker DB plumbing without touching the user's production Hive Desktop. Use this when something is wrong in the create_colony → tracker → run_parallel_workers → worker pipeline.
Installation
Add queen-colony-debug to your agent with:
git clone https://github.com/aden-hive/hive ~/.claude/skills/queen-colony-debugAlways review a skill's source before installing it. This command comes from the skill's public repository; the linked repo is the source of truth for exact setup steps.
What's inside
The SKILL.md for queen-colony-debug is organised into these sections:
- Trigger
- Hard rules
- What "correct" looks like (key invariants)
- SOP
- Step 1 — Pick a runtime
- Step 2 — Snapshot the starting state
- Step 3 — Drive the failing flow
- Step 4 — Verify with sqlite3 directly
- Step 5 — Test refusal behavior without an LLM
- Step 6 — Test queen↔worker tracker sharing (offline)
- Step 7 — Shut down cleanly
- Common failure patterns
When to use it
Reach for queen-colony-debug when you want workflow help from your agent without writing the same instructions every session. Load the skill and the agent picks it up automatically for relevant tasks.
Strengths
- Clear Apache-2.0 license — safe to read and adapt
- Ships in aden-hive/hive, an established project with 10,923 GitHub stars
- Actively maintained (recent commits)
Things to check
- Sparse description in metadata — read the repository for full details
Topics
Frequently asked questions
- What does queen-colony-debug do?
- queen-colony-debug is an open-source workflow skill for Claude Code and compatible agents, published by aden-hive. It packages reusable instructions an agent loads on demand to help with workflow tasks. The project has 11k stars on GitHub and is available under the Apache-2.0 license. Add it to your setup with `git clone https://github.com/aden-hive/hive ~/.claude/skills/queen-colony-debug`.
- How do I install queen-colony-debug?
- Run git clone https://github.com/aden-hive/hive ~/.claude/skills/queen-colony-debug in your agent, then reload your skills. Review the source at https://github.com/aden-hive/hive before installing.
- Is queen-colony-debug free to use?
- Yes. queen-colony-debug is free and open source under the Apache-2.0 license, so you can read, run, and adapt it within that license's terms.
- Where does queen-colony-debug come from?
- queen-colony-debug ships inside aden-hive/hive, a repository that contains 25 catalogued skills in total. The repository's 10,923 GitHub stars apply to that whole collection, not to this skill on its own.
Related skills
More Workflow →test-reporting is an open-source workflow skill for Claude Code and compatible agents, published by aden-hive. It packages reusable instructions an agent loads on demand to help with workflow tasks. The project has 11k stars on GitHub and is available under the Apache-2.0 license. Add it to your setup with `git clone https://github.com/aden-hive/hive ~/.claude/skills/test-reporting`.
triage-issue is an open-source workflow skill for Claude Code and compatible agents, published by aden-hive. It packages reusable instructions an agent loads on demand to help with workflow tasks. The project has 11k stars on GitHub and is available under the Apache-2.0 license. Add it to your setup with `git clone https://github.com/aden-hive/hive ~/.claude/skills/triage-issue`.
Required before any hive-browser CLI command. The browser is driven from the terminal by running `hive-browser <command> ... --json` via terminal_exec — not via MCP tools. Teaches the browser lifecycle rules (the bridge attaches to the USER'S running Chrome — never kill or launch browser processes; timeouts are transport issues, not crashes), the screenshot + coordinate workflow (hive-browser interact with a fractional coordinate) that reaches shadow-DOM inputs selectors can't see, the viewport-fraction coordinate rule (not pixels), rich-text editor quirks ("send button stays disabled" failures), and CSP gotchas. Covers Chrome via CDP through the GCU Beeline extension.
Claim tasks, record step progress, and verify SOP gates in the colony SQLite queue. Applies when your spawn message includes a db_path field.