Install any skill in seconds. Free to start, no credit card required.
Get Started Free →gastownhall/beads
Use when working in a repository that uses bd or Beads for durable project task tracking, issue dependencies, blocker management, multi-session handoff, or shared work memory. Trigger when the user asks to find ready work, claim or close tasks, create follow-up work, inspect blockers, recover project context, or choose between local planning and persistent project tracking.
Passed 21 of 22 test cases with the skill, and 11 of 22 without it.
and 9 more in the full report
10 fixed12 passed either way1 still failing0 broke
Tokens, turns and time describe resource use, not a dollar price.
One of 10 test cases the skill fixed. Same model, same prompt, with and without the skill.
I am creating a task entry 'Token storage' in Beads that must block another task named 'oauth-id'. What flag syntax configures this dependency relationship?
| Checked | Without skill | With skill |
|---|---|---|
| Uses `--deps blocks:oauth-id` flag syntax when creating dependent tasks. | Missed | Passed |
The instructions your model reads when the skill loads.
Graph-based issue tracker that survives conversation compaction. Provides persistent memory for multi-session work with complex dependencies.
Decision test: "Will I need this context in 2 weeks?" YES = bd, NO = TodoWrite.
| bd (persistent) | TodoWrite (ephemeral) |
|---|---|
| Multi-session, dependencies, compaction survival | Single-session linear tasks |
| Dolt-backed team sync | Conversation-scoped |
See BOUNDARIES.md for detailed comparison.
bd --version # Requires v0.60.0+
BEADS_DIR + --stealth for git-free operation)bd init run once (humans do this, not agents)Run bd prime for AI-optimized workflow context (auto-loaded by hooks).
Run bd <command> --help for specific command usage.
Essential commands: bd ready, bd create, bd show, bd update, bd close, bd dolt push
bd ready — Find unblocked workbd show <id> — Get full contextbd update <id> --claim — Claim and start work atomicallybd close <id> --reason "..." — Complete taskbd dolt push — Push to Dolt remote (if configured)test cases passed, vs 11 / 22 without
Published skills whose descriptions closely match this one, with their headline benchmark lift.
More skills from the same source and nearby in the registry, with their headline benchmark lift.