MVPavan/via / .claude/skills/beads
beads
VerifiedUse for Beads dependencies, intake states, recovery, workstream tracking, or unfamiliar task-lifecycle operations. Routine tracking uses AGENTS.md and runtime context.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 2.1 KB |
| agents/openai.yaml | config | 42 B |
| references/commands.md | markdown | 1.9 KB |
| scripts/bd-render-tracking.shexecutable | script | 10.7 KB |
references/commands.md
View on GitHub# Beads command reference
## Cheat-sheet
| Goal | Command |
|------|---------|
| Recover context / session-close protocol | `bd prime` |
| Ready (unblocked) work | `bd ready` |
| List by status | `bd list --status=open\|in_progress\|closed` |
| Inspect one issue | `bd show <id>` |
| Search text | `bd search "<query>"` — titles + open only; add `--status all` and use `--desc-contains` for full search |
| Create | `bd create "title" --description="why + what" -t task\|bug\|feature\|epic\|chore\|decision -p 0..4` |
| Claim | `bd update <id> --claim` |
| Edit fields | `bd update <id> --title/--description/--notes/--append-notes/--design/--priority/--status` |
| Close (one or many) | `bd close <id> [<id>…] [--reason="…"]` |
| Dependencies | `bd dep add <id> <depends-on>` · `bd dep tree <id>` · `bd blocked` |
| Labels | `bd label add\|remove <id> <label>` · `bd list -l <label>` · `bd label list-all` |
| Human-attention queue | `bd human list` · `bd human respond\|dismiss <id>` |
| Lifecycle | `bd defer <id> --until=<date>` · `bd supersede <id> --with=<id>` · `bd stale` · `bd orphans` |
| Epics | create: `-t epic [--spec-id <path>]` · child: `bd create … --parent <epic-id>` · `bd epic status` · `bd epic close-eligible` · children: `bd list --parent <id>` · by spec: `bd list --spec <prefix>` |
| Stats / health | `bd stats` (quick summary) · `bd lint` · `bd stale` · `bd orphans` · `bd gc` / `bd prune` |
Priority is `0..4` (0=critical), not high/med/low. Never `bd edit` (opens $EDITOR — use `bd update` flags). Add `--json` to parse output. Close only when the work is actually done.
Maintenance — on-demand, not per session: use the stats/health row above. Run `bd preflight --check` only when its checks match this repo's current toolchain; this CLI version includes some Go-specific checks.
Check current `bd <command> --help` for unfamiliar flags.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| reverse-engineer-anythingmorluto/reaReverse engineer native, managed, Electron/JavaScript, packaged, firmware, and browser targets with REA, and build agent environments (AgentEnv bundles) of web applications from a live instance or a capture, and of Linux desktop apps with a task from a request. Use shipped-artifact or requested runtime evidence to explain features, compare versions, decompile code, or guide a reconstruction. Skip REA for ordinary source-repository architecture analysis. | Stars: 471k | Updated | Claude CodeCodex | Verified | Install |
| diagnosing-superpowersobra/superpowersUse when a superpowers session went wrong and your human partner wants to know why — repeated work, ignored plans, stumbles, poor results, a skill that didn't fire, "it took too long", "why is it so expensive", "what is it doing" — or wants to build a bug report for the superpowers maintainers, for the current session or a past one identified by id or path, on any harness. | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| dispatching-parallel-agentsobra/superpowersUse when facing 2+ independent tasks that can be worked on without shared state or sequential dependencies | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |
| executing-plansobra/superpowersUse when executing an implementation plan in the current session as the implementer yourself — your human partner chose inline execution, or no subagent tool is available | Stars: 322k | Updated | Claude CodeCodex | Verified | Install |