beads
Beads is a git-backed, AI-native issue tracking system that helps manage tasks through commands like bd prime, bd ready, and bd create. Use it to start work sessions, create and update issues with types and priorities, manage task dependencies, run workflow formulas, and coordinate multi-session development work while maintaining mandatory sync operations.
git clone --depth 1 https://github.com/maslennikov-ig/claude-code-orchestrator-kit /tmp/beads && cp -r /tmp/beads/.claude/skills/beads ~/.claude/skills/beadsSKILL.md
# Beads Issue Tracking Skill > **Attribution**: [Beads](https://github.com/steveyegge/beads) by [Steve Yegge](https://github.com/steveyegge) ## Description Beads is a git-backed, AI-native issue tracking system. This skill helps AI agents work with Beads effectively. ## When to Use - Starting a new work session (bd prime → bd ready) - Creating, updating, or closing issues - Managing task dependencies - Running workflow formulas - Coordinating multi-session work ## Quick Reference ### Session Workflow ```bash # START bd prime # Inject context bd ready # Find available work # WORK bd update ID --status in_progress # Take task # ... implement ... bd close ID --reason "Done" # Complete task /push patch # Commit # END (MANDATORY!) bd sync git push ``` ### Issue Creation ```bash # Basic bd create "Title" -t type -p priority # With files (auto-labels) bd create "Fix button" --files src/components/Button.tsx # Emergent work bd create "Found bug" -t bug --deps discovered-from:current-id ``` ### Types & Priorities | Type | When | |------|------| | feature | New functionality | | bug | Bug fix | | chore | Tech debt, config | | docs | Documentation | | test | Tests | | epic | Group of tasks | | Priority | Meaning | |----------|---------| | 0 | Critical (blocks release) | | 1 | Critical | | 2 | High | | 3 | Medium (default) | | 4 | Low / backlog | ### Formulas (Workflows) ```bash bd formula list # List all bd mol wisp exploration --vars "question=How?" # Ephemeral bd mol pour bigfeature --vars "feature_name=auth" # Persistent bd mol squash WISP_ID # Save result bd mol burn WISP_ID # Discard ``` ## Resources See `resources/` for detailed guides: - COMMANDS_QUICKREF.md - Command cheat sheet - DECISION_MATRIX.md - When to use what - WORKFLOWS.md - Common workflows - SPECKIT_BRIDGE.md - Integration with Spec-kit ## Integration with Spec-kit For large features (>1 day): 1. `/speckit.specify` → requirements 2. `/speckit.plan` → design 3. `/speckit.tasks` → task breakdown 4. `/speckit.tobeads` → import to Beads 5. `bd ready` → work with Beads ## Links - [Beads GitHub](https://github.com/steveyegge/beads) - [CLI Reference](https://github.com/steveyegge/beads/blob/main/docs/CLI_REFERENCE.md)
Creating algorithmic art using p5.js with seeded randomness and interactive parameter exploration. Use this when users request creating art using code, generative art, algorithmic art, flow fields, or particle systems. Create original algorithmic art rather than copying existing artists' work to avoid copyright violations.
Suite of tools for creating elaborate, multi-component claude.ai HTML artifacts using modern frontend web technologies (React, Tailwind CSS, shadcn/ui). Use for complex artifacts requiring state management, routing, or shadcn/ui components - not for simple single-file HTML/JSX artifacts.
Initialize Beads issue tracking in your project with interactive configuration setup.
Calculate priority score for bugs, issues, or tasks based on severity, impact, and likelihood. Use for bug prioritization, task ordering, or risk assessment.
Create beautiful visual art in .png and .pdf documents using design philosophy. You should use this skill when the user asks to create a poster, piece of art, design, or other static piece. Create original visual designs, never copying existing artists' work to avoid copyright violations.
Automatically creates user-facing changelogs from git commits by analyzing commit history, categorizing changes, and transforming technical commits into clear, customer-friendly release notes. Turns hours of manual changelog writing into minutes of automated generation.
Inline orchestration workflow for dead code detection and removal with Beads integration. Provides step-by-step phases for dead-code-hunter detection, priority-based cleanup with dead-code-remover, and verification cycles.
Analyzes code changes for bugs, security vulnerabilities, performance problems, and architectural improvements. Generates structured markdown reports with evidence-based findings tied to specific file:line references, and creates Beads tasks for tracking. Adapts review depth based on scope — from quick pre-commit checks to thorough branch reviews. Use proactively when reviewing code before commits, after implementing features, before PRs, when checking code quality, or when the user mentions "review", "check changes", "code review", "PR review", "review branch", or any code quality assessment.