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.
Install
npx skills add gastownhall/beads --skill beadsnpx skills add gastownhall/beads --skill beads -a claude-code -gnpx skills add gastownhall/beads --skill beads -a codex -ggemini skills install https://github.com/gastownhall/beads.git --path internal/templates/skills/beadsgh skill install gastownhall/beads beadsgit clone --depth 1 https://github.com/gastownhall/beads /tmp/gastownhall__beads
mkdir -p ~/.claude/skills ~/.agents/skills
cp -R /tmp/gastownhall__beads/internal/templates/skills/beads ~/.claude/skills/beads # Claude Code
cp -R /tmp/gastownhall__beads/internal/templates/skills/beads ~/.agents/skills/beads # Codex, Cursor, Gemini CLI, Copilot, OpenCode