beads
Issue tracking with Beads (bd CLI). Use when commands need to create, query, update, or close issues, or manage dependencies.
Best use case
beads is best used when you need a repeatable AI agent workflow instead of a one-off prompt.
Issue tracking with Beads (bd CLI). Use when commands need to create, query, update, or close issues, or manage dependencies.
Teams using beads should expect a more consistent output, faster repeated execution, less prompt rewriting.
When to use this skill
- You want a reusable workflow that can be run more than once with consistent structure.
When not to use this skill
- You only need a quick one-off answer and do not need a reusable workflow.
- You cannot install or maintain the underlying files, dependencies, or repository context.
Installation
Claude Code / Cursor / Codex
Manual Installation
- Download SKILL.md from GitHub
- Place it in
.claude/skills/beads-majiayu000/SKILL.mdinside your project - Restart your AI agent — it will auto-discover the skill
How beads Compares
| Feature / Agent | beads | Standard Approach |
|---|---|---|
| Platform Support | Not specified | Limited / Varies |
| Context Awareness | High | Baseline |
| Installation Complexity | Unknown | N/A |
Frequently Asked Questions
What does this skill do?
Issue tracking with Beads (bd CLI). Use when commands need to create, query, update, or close issues, or manage dependencies.
Where can I find the source code?
You can find the source code on GitHub using the link provided at the top of the page.
SKILL.md Source
# Beads Issue Tracker ## Core Concepts - **bd ready** — tasks with no blockers - **Status**: open → in_progress → closed - **Types**: task, bug, feature, epic, chore - **Priority**: 0 (critical) → 4 (low), default 2 - **Dependencies**: only `blocks` affects ready ## Operations ### Get Issue Details ```bash bd show <id> --json ``` Returns full issue data: title, description, status, type, priority, dependencies. ### Check If Issue Exists ```bash bd show <id> ``` Exit code 0 = exists, non-zero = not found. ### Create Issue ```bash bd create --title "Title" --type task --priority 2 --description "Description" --json ``` Creates new issue. Use `--parent <epic-id>` for subtasks. ### Update Status ```bash bd update <id> --status in_progress --json ``` Valid statuses: open, in_progress, closed. ### Add Dependency ```bash bd dep add <blocked-id> <blocker-id> --type blocks ``` Makes blocker-id block blocked-id. Only `blocks` affects ready state. ### Get Dependency Tree ```bash bd dep tree <id> ``` Shows issue hierarchy and blocking relationships. ### Find Ready Tasks ```bash bd ready --json ``` Lists tasks with no unresolved blockers. ### Find Blocked Tasks ```bash bd blocked --json ``` Lists tasks waiting on blockers. ### Close Issue ```bash bd close <id> --reason "Done: summary" --json ``` Marks issue as closed with resolution reason. ### List Issues ```bash bd list --status open --json ``` Filter by status, type, priority. ### Sync ```bash bd sync ``` Synchronizes local state with remote. ## Quick Reference | Action | Command | |--------|---------| | Show issue | `bd show <id> --json` | | Create issue | `bd create --title "..." --type task --json` | | Update status | `bd update <id> --status in_progress` | | Add blocker | `bd dep add <blocked> <blocker> --type blocks` | | Ready tasks | `bd ready --json` | | Close issue | `bd close <id> --reason "..."` | ## References - `references/types.md` — Issue types and priorities - `references/dependencies.md` — Dependency types and usage
Related Skills
beads-worker
Implement exactly one Beads task in a dedicated git worktree/branch with plan→code→self-review and write full updates back to the task. Use when implementing a Beads task, coding in a worktree, or executing a single task implementation.
beads-reviewer
Independently review a Beads task implementation (commits + diff + checks), write findings back to the task, and provide a merge verdict. Use when reviewing code, checking implementations, or validating task branches before merge.
beads-seed
Translate architectural planning documents into actionable beads issue graph structure.
write-beads
Convert a Technical Design Document into a BEADS.md file for agent implementation
beads-orchestration
Multi-agent orchestration for GitHub Issues using BEADS task tracking
beads-integrator
Merge Beads task branches into main/master safely (serialized), verify, push to remote, record merge SHAs back into tasks, and clean worktrees. Use when merging branches, integrating code to base branch, or finalizing reviewed task branches.
bgo
Automated Blender build-go workflow. Automatically builds, removes old version, installs, enables, and launches Blender with your extension/add-on. Use when you want to quickly test changes, execute complete build-to-launch cycle, or run custom packaging scripts with automatic Blender launch.
jj-workflow
Jujutsu atomic workflow with full operational reference for jj-based repositories.
jj-vcs-workflow
Jujutsu (jj) VCS の総合ガイド。基本コマンド・Git移行・並列開発・履歴操作・PRレビュー・安全な push ワークフローをカバー。以下の場合に使用: (1) jj コマンドの使い方を確認したいとき (2) Git から jj への移行時 (3) 並列開発・履歴書き換え・コンフリクト解消を行うとき (4) PR レビュー対応時 (5) push を実行したいとき
jenkinsfile-validator
Comprehensive toolkit for validating, linting, testing, and automating Jenkinsfile pipelines (both Declarative and Scripted). Use this skill when working with Jenkins pipeline files, validating pipeline syntax, checking best practices, debugging pipeline issues, or working with custom plugins.
jarvis-autonomous
Fully autonomous AI agent with self-improvement, GitHub automation, and Telegram control. Creates projects, learns continuously, and manages itself proactively.
iterm-worktree
Manage git worktrees with iTerm2 integration. Use when user asks to create isolated development environments, work on features in parallel, manage worktrees, open worktrees in new tabs/windows, switch between worktrees, or close completed worktrees. Triggers on "create worktree", "new worktree", "feature branch with worktree", "open worktree", "switch worktree", "close worktree", "list worktrees", or mentions wanting to work on multiple features simultaneously.