🔍
QualityPython

Queen Colony Debug

by aden-hive

Queen Colony Debug is a Quality skill for Claude Code, published by aden-hive in hive.

10.9K stars5.7K forkson aden-hive/hiveAdded 2026/08/15Repository updated 2026/08/13
agentagent-frameworkagent-skillsanthropicautomationautonomous-agentsclaudeharnessharness-engineeringhuman-in-the-loopopenaipythonself-hostedself-improving
Install in seconds
Install Queen Colony Debug
Copy Queen Colony Debug into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.
terminal
npx degit https://github.com/aden-hive/hive/tree/main/.claude/skills/queen-colony-debug ~/.claude/skills/queen-colony-debug

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/aden-hive/hive.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file
.claude/skills/queen-colony-debug/SKILL.md in aden-hive/hive
Installs to
~/.claude/skills/queen-colony-debug
Collection
One of 24 skills cataloged from this repository
Category
Quality1354 skills

What Queen Colony Debug does

Queen Colony Debug is a standard operating procedure for live debugging queen sessions, colony forks, worker spawns, and tracker DB plumbing without touching the user's production Hive Desktop. Use it to verify invariants in the create_colony → tracker → run_parallel_workers → worker pipeline.

Queen Colony Debug is cataloged under Quality on DirSkills. Queen Colony Debug comes from a repository tagged agent, agent-framework, agent-skills, anthropic and automation.

Documentation

README

Queen / Colony Debug Skill

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.

Trigger

User asks you to debug, reproduce, or verify behavior in:

  • Queen DM sessions, colony sessions, fork_session_into_colony
  • ColonyBinding propagation (queen exec context, worker input_data)
  • tracker_sql / tracker_register_writable / tracker_upsert / tracker_query
  • run_parallel_workers preflight
  • Phantom colonies/session_<uuid>/ shadow folders (the original split-brain bug)
  • Session resume from disk, queen phase transitions (independent → incubating → colony)

This is the opening of the README. Read the full README on GitHub.

Commands Queen Colony Debug provides

Slash commands named in this skill’s SKILL.md, listed in the order they first appear.

  • /colony-spawn

Frequently asked about Queen Colony Debug

  • What else does aden-hive publish alongside Queen Colony Debug?

    Queen Colony Debug is one of 24 skills that DirSkills catalogs from aden-hive/hive, the repository it ships in. Its siblings there include Background Job Control, Browser Edge Cases and Chart Creation Foundations. Each one is a separate skill with its own page in this directory, installs the same way Queen Colony Debug does, and is maintained by aden-hive in that same repository. The rest of the collection is listed on the aden-hive/hive page.

  • How does Queen Colony Debug compare to other Quality skills?

    Queen Colony Debug ranks #191 by stars among the 1354 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Queen Colony Debug against them. Open each page to compare what they document and how they install.

More from aden-hive/hive

Queen Colony Debug is one of 24 skills cataloged on DirSkills from aden-hive/hive.

See all 24 skills
2w ago

Background Job Control

Background Job Control manages long-running terminal jobs using start, poll, wait, and signal tools. Use it before launching builds, deploys, streaming logs, or taking over auto-backgrounded processes from terminal_exec.
Automation
10.9K5.7K
🔍
2w ago

Browser Edge Cases

Browser Edge Cases provides a standard operating procedure for debugging browser automation failures on complex websites. Use it when browser tools fail on LinkedIn, Twitter/X, SPAs, or sites with Shadow DOM.
Automation
10.9K5.7K
📊
2w ago

Chart Creation Foundations

Chart Creation Foundations teaches the one-tool embedding contract for rendering BI/financial-grade ECharts and Mermaid charts that appear live in chat and save as high-DPI PNGs. Use it whenever chart_* tools are available to avoid chartjunk and missing downloads.
Data
10.9K5.7K
📋
2w ago

Colony Progress Tracker

Colony Progress Tracker claims tasks, records step progress, and verifies SOP gates in a shared SQLite queue. Use when your spawn message includes db_path and colony_id fields.
Automation
10.9K5.7K
🧠
2w ago

Context Preservation

Context Preservation proactively extracts critical values from tool results into working notes before automatic context pruning destroys them. Use it when an agent must retain URLs, API fields, IDs, and analysis conclusions across long tasks.
AI Engineering
10.9K5.7K
🔁
2w ago

Error Recovery

Error Recovery guides an agent through a decision tree for tool call failures: retry transient errors once, fix and retry structural ones, or escalate if blocking. It switches tools after repeated failures and logs failed tasks to a database.
AI Engineering
10.9K5.7K