beads

beads-skill

Note: This skill has moved to github.com/sttts/skills and will be maintained there going forward.

Claude Code plugin for beads issue tracking workflow.

Installation

# Add the marketplace
/plugin marketplace add sttts/beads-skill

# Install the plugin
/plugin install beads

What it does

This plugin provides a skill that activates when your project has a .beads directory. It guides Claude through:

• Running bd prime at session start
• Checking ready tasks with bd ready --pretty
• Creating tasks and epics with sensible ID conventions
• Managing task state (in-progress, closed)
• PR/MR URL labeling on tasks
• Worktree management for epics
• Session completion workflow (the "landing the plane" checklist)

Trigger phrases

The skill activates when you mention:

• "bd", "beads"
• "what's next"
• "add task", "add epic"
• Issue tracking related queries

It will first check for a .beads directory - if not present, the skill does not apply.

Requirements

• beads CLI installed
• A project with a .beads directory

License

MIT