johnlindquist/claude/beads

Claude Code and agent skill by johnlindquist/claude

Trust tier 2
  • community
LLM review pending
Source check pending

Checking that the SKILL.md file is still in the repository.

Track tasks and issues using the bd CLI. Use for task management, sprint planning, dependency tracking, and project organization. Replaces TodoWrite.

Install

npx vskill@latest install johnlindquist/claude/beads

SKILL.md

Beads Issue Tracker

Git-backed issue tracking with dependency awareness. Perfect for agent task management.

Prerequisites

Install beads:

bash
# Install via cargo or download binary
cargo install beads
# Or download from releases

Initialize in a project:

bash
bd init

CLI Reference

View Ready Work
bash
# Get issues with no blockers
bd ready --json
 
# Filter by assignee
bd ready --assignee username --json
 
# Filter by label
bd ready --label "urgent" --json
 
# Limit results
bd ready --limit 5 --json
Create Issues
bash
# Basic task
bd create "Task title" --json
 
# With details
bd create "Task title" -d "Description" -t task -p 2 --json
 
# As subtask of epic
bd create "Subtask" --parent epic-123 --force --json
 
# With dependencies
bd create "Task" --deps "other-issue-id" --json
 
# Quick mode (less output)
bd create "Task" -q --json
Issue Types
  • bug - Bug reports
  • feature - New features
  • task - General tasks
  • epic - Parent containers
  • chore - Maintenance work
Priority Levels
  • 0 - Critical
  • 1 - High
  • 2 - Normal (default)
  • 3 - Low
  • 4 - Backlog
Update Issues
bash
# Change status
bd update issue-id -s in_progress --json
 
# Add notes
bd update issue-id --notes "Progress update" --json
 
# Change priority
bd update issue-id -p 1 --json
 
# Add labels
bd update issue-id --add-label "urgent" --json
Close Issues
bash
# Close with reason
bd close issue-id -r "Completed successfully" --json
List Issues
bash
# All open issues
bd list --status open --json
 
# Filter by type
bd list --type bug --json
 
# Filter by assignee
bd list --assignee "username" --json
 
# Filter by label
bd list --label "backend" --json
 
# Filter by priority
bd list --priority 1 --json
Show Issue Details
bash
bd show issue-id --json
Dependencies
bash
# Add dependency (issue-a depends on issue-b)
bd dep add issue-a issue-b
 
# Dependency types: blocks, related, parent-child, discovered-from
bd dep add issue-a issue-b -t blocks
Sync with Git
bash
# Sync issues to git remote
bd sync
Hygiene Commands
bash
# Find duplicate issues
bd duplicates --dry-run
 
# Auto-merge duplicates
bd duplicates --auto-merge
 
# Find stale issues (no activity)
bd stale --days 14 --json
 
# Cleanup old closed issues
bd cleanup --dry-run
bd cleanup -f
Install Git Hooks
bash
# Auto-sync on commit
bd hooks install
System Info
bash
# Check version
bd --version
 
# Project info
bd info --json

Workflow Patterns

Session Start
bash
# See what's ready to work on
bd ready --json
Working on a Task
bash
# Start working
bd update task-id -s in_progress --json
 
# Add progress notes
bd update task-id --notes "Halfway done" --json
 
# Complete
bd close task-id -r "Implemented and tested" --json
Epic Planning
bash
# Create epic
bd create "User Authentication" -t epic --json
 
# Add subtasks
bd create "Design auth flow" --parent auth-epic --force --json
bd create "Implement login" --parent auth-epic --force --json
bd create "Add tests" --parent auth-epic --force --json
 
# Add dependencies between subtasks
bd dep add implement-id design-id -t blocks
bd dep add tests-id implement-id -t blocks
End of Session
bash
# Sync to git
bd sync

Worktree Mode

When using git worktrees, disable the daemon:

bash
export BEADS_NO_DAEMON=1
# Or per-command
bd --no-daemon ready --json

Best Practices

  1. Always use `--json` for parseable output
  2. Use `bd ready` at session start to see unblocked work
  3. Add dependencies to express task relationships
  4. Use epics for grouping related tasks
  5. Run `bd sync` before ending sessions
  6. Install hooks for automatic sync: bd hooks install

Security

  • Security scanPassed, 100 of 100Pattern checks on the skill's files.
  • Model reviewNot runA model review is scheduled for the next rescan.

See the full security report

Quality evaluation

  • Task evaluationNot runNo evaluation yet. Run one in Skill Studio.

See evaluation results

Source

Popularity

Repository stars
21
Repository forks
5
7-day trend score
15

Stars and forks are for the whole GitHub repository, not this skill alone. Refreshed 1 Apr 2026, 7 months ago.

Works with

Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.

  • Claude Code
  • Cursor
  • GitHub Copilot
  • Windsurf
  • Codex
  • Gemini CLI
  • Cline
  • Amp
  • Roo Code
  • Goose
  • Continue
  • Kilo Code
  • Junie
  • Trae
  • OpenHands
  • Qwen Code
  • AI Agent
  • Tabnine Chat
  • Sourcegraph Cody
  • Amazon Q
  • Firebase Genkit
  • Sweep
  • Devin
  • Phind
  • Mentat
  • Claude Desktop
  • Aider
  • GPT Pilot
  • Plandex
  • bolt.new
  • v0
  • Replit Agent
  • Anse
  • TypingMind
  • BetterChatGPT
  • LibreChat
  • Warp AI
  • Pieces
  • Fig AI
Embed badge
vskill VERIFIED badge
[![vskill VERIFIED](https://verified-skill.com/api/v1/skills/johnlindquist/claude/beads/badge)](https://verified-skill.com/skills/johnlindquist/claude/beads)

Something wrong with this skill or its page? Tell us.