How do I install the Beads skill?

Run npx skillmds@latest add diegosouzapw/beads in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

What does the Beads skill do?

Manages issues and dependencies through the Beads CLI, covering creation, updates, queries, and closure. It is listed under Coding & Dev Tools, AI & ML, Productivity, Dev Tooling, Task Management on SkillMD.

Is Beads safe to use?

SkillMD's automated safety review verdict for this skill is PASS. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. Capability flags: makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Beads?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Beads free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

diegosouzapw (@diegosouzapw) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Beads by diegosouzapw — Agent Skill

Name: Beads
Rating: 4.2 (5 reviews)
Author: diegosouzapw

File contents

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

bd show <id> --json

Returns full issue data: title, description, status, type, priority, dependencies.

Check If Issue Exists

bd show <id>

Exit code 0 = exists, non-zero = not found.

Create Issue

bd create --title "Title" --type task --priority 2 --description "Description" --json

Creates new issue. Use --parent <epic-id> for subtasks.

Update Status

bd update <id> --status in_progress --json

Valid statuses: open, in_progress, closed.

Add Dependency

bd dep add <blocked-id> <blocker-id> --type blocks

Makes blocker-id block blocked-id. Only blocks affects ready state.

Get Dependency Tree

bd dep tree <id>

Shows issue hierarchy and blocking relationships.

Find Ready Tasks

bd ready --json

Lists tasks with no unresolved blockers.

Find Blocked Tasks

bd blocked --json

Lists tasks waiting on blockers.

Close Issue

bd close <id> --reason "Done: summary" --json

Marks issue as closed with resolution reason.

List Issues

bd list --status open --json

Filter by status, type, priority.

Sync

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

---name: beadsdescription: Manages issues and dependencies through the Beads CLI, covering creation, updates, queries, and closure.---# 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```bashbd show <id> --json```Returns full issue data: title, description, status, type, priority, dependencies.### Check If Issue Exists```bashbd show <id>```Exit code 0 = exists, non-zero = not found.### Create Issue```bashbd create --title "Title" --type task --priority 2 --description "Description" --json```Creates new issue. Use `--parent <epic-id>` for subtasks.### Update Status```bashbd update <id> --status in_progress --json```Valid statuses: open, in_progress, closed.### Add Dependency```bashbd dep add <blocked-id> <blocker-id> --type blocks```Makes blocker-id block blocked-id. Only `blocks` affects ready state.### Get Dependency Tree```bashbd dep tree <id>```Shows issue hierarchy and blocking relationships.### Find Ready Tasks```bashbd ready --json```Lists tasks with no unresolved blockers.### Find Blocked Tasks```bashbd blocked --json```Lists tasks waiting on blockers.### Close Issue```bashbd close <id> --reason "Done: summary" --json```Marks issue as closed with resolution reason.### List Issues```bashbd list --status open --json```Filter by status, type, priority.### Sync```bashbd 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

Frequently asked questions

Beads