Skip to content
Get packs

Queen Colony Debug

Debug Hive queen sessions, colony forks, and worker tracker plumbing in an isolated server

Source Download skill
Repository
aden-hive/hive
Stars
11,132
Licence
Apache-2.0
Files
1 file

What it does

This skill gives an AI agent a step-by-step procedure for diagnosing bugs in the Hive agent system's colony pipeline (creating a colony from a queen chat, sharing a tracker database with workers, and spawning parallel workers). It tells the agent to start a separate test copy of the Hive server with an isolated data folder, send scripted requests to it, and check specific expected results such as folder layout and configuration keys, so the user's real Hive Desktop installation is left alone.

Great for

  • Engineers working on the Hive codebase who need to reproduce colony or tracker bugs
  • Contributors verifying that a refactor of the queen/colony binding did not break behavior

Skip it if

  • Ordinary end users of Hive Desktop who just want to use the app, since the procedure is for developers debugging internals
  • Debugging unrelated projects, because the checks and file paths are specific to the Hive repository

Try asking

  • “Debug why a queen says there is no such table when calling tracker tools”
  • “Check whether a phantom colonies/session_<uuid> folder appears after starting a DM session”
  • “Verify that worker.json input_data contains only the binding key after forking a session into a colony”
  • “Confirm that run_parallel_workers logs the expected binding line”
Step-by-step guide: how to use Queen Colony DebugInstall, first run, examples, tips and FAQs

Install in 3 steps

  1. 1

    Download the skill

    The ZIP contains the 1 original files, the Apache-2.0 licence and an attribution note.

    queen-colony-debug.zip
  2. 2

    Add it to your agent

    Claude Code (all projects)

    mkdir -p ~/.claude/skills && unzip queen-colony-debug.zip -d ~/.claude/skills/

    Claude Code / Agent SDK (this project only)

    mkdir -p .claude/skills && unzip queen-colony-debug.zip -d .claude/skills/

    Claude apps (web/desktop): Settings → Capabilities → Skills → Upload skill, and choose the ZIP.

  3. 3

    Ask for the task

    No special command needed — the agent reads the skill's description and loads it when your request matches. Try one of the prompts above.

Get better results

  • Start with the isolated HIVE_HOME=/tmp/hive_e2e path and the non-LLM colony-spawn route to avoid spending credits
  • Only point the agent at the real Hive Desktop data folder when you explicitly ask for live verification
  • Keep prompts to the queen terse and deterministic to reduce cost and variability

What's inside

  • SKILL.md

Redistributed unmodified from aden-hive/hive under the Apache-2.0 licence. The assessment was drafted with AI from the skill's files on 2026-10-29. Skills can instruct your agent to run code — read SKILL.md and any scripts before installing.