skillZs
★ LIVE SKILL TAGS ★
>>> LIVE SKILLS INDEX <<<
* OPEN SOURCE *
NO LOGIN, NO TRACKING
※ REAL INSTALL DATA ※
← back to all skills
dralgorhythm/claude-agentic-framework54 installs

beads-workflow

AI-native issue tracking with Beads. Use when managing work items, tracking issues, or coordinating tasks in multi-agent workflows. Covers bd commands, dependencies, and sync patterns.

How do I install this agent skill?

npx skills add https://github.com/dralgorhythm/claude-agentic-framework --skill beads-workflow
view source ↗

Is this agent skill safe to install?

  • Gen Agent Trust Hubpass

    This skill provides a comprehensive workflow for using Beads (bd), an AI-native issue tracking tool. It details commands for issue lifecycle management, dependency tracking, and synchronization with GitHub. No malicious code, data exfiltration, or suspicious dependencies were identified.

  • Socketpass

    No alerts

  • Snykwarn

    Risk: MEDIUM · 1 issue

  • Runlayerpass

    1 file scanned · No issues

What does this agent skill do?

Beads Workflow

Beads is an AI-native issue tracker designed for agent workflows. Issues live in your repo, sync via git, and require no web UI.

Core Commands

CommandDescription
bd create "Title" -t feature -p 2Create issue (type, priority)
bd list --status openList open issues
bd show <id>View issue details
bd update <id> --status in_progressUpdate status or assignee
bd close <id> --reason "..."Close with reason
bd ready --sort hybridFind unblocked issues
bd dep add <blocking> <blocked> --type blocksAdd dependency
bd dep tree <id>View dependency tree
bd dep rm <blocking> <blocked>Remove dependency
bd syncSync with git remote
bd flushForce flush to JSONL

Workflow Patterns

Starting a Session

  1. Check ready work: bd ready --sort hybrid
  2. Claim an issue: bd update <id> --status in_progress
  3. Review dependencies: bd dep tree <id>
  4. Begin implementation

During Implementation

  1. Track sub-tasks: bd create "Sub-task" --parent <id>
  2. Add blockers: bd dep add <new-blocker> <id> --type blocks
  3. Update progress: bd comment <id> "Progress update"

Completing Work

  1. Verify completion: All acceptance criteria met
  2. Close issue: bd close <id> --reason "Implemented X, PR #123"
  3. Sync: bd sync
  4. Check next: bd ready

Multi-Agent Coordination

# See who's working on what
bd list --status in_progress --json | jq '.[] | {id, title, assignee}'

# Hand off work
bd update <id> --assignee other-agent
bd comment <id> "Handoff: context and next steps"

Issue Types

TypeWhen to Use
featureNew functionality
bugDefect fixes
taskGeneral work items
spikeResearch/investigation
choreMaintenance, cleanup

Priority Levels

PriorityMeaning
0Critical - Drop everything
1High - Next up
2Medium - Normal flow
3Low - When time permits
4Backlog - Future consideration

Status Flow

open -> in_progress -> done
         |-> blocked -> in_progress

Best Practices

  1. One issue per logical unit: Don't combine unrelated work
  2. Clear titles: Should explain what, not how
  3. Use dependencies: Makes ready work visible
  4. Sync frequently: Keep other agents informed
  5. Close promptly: Don't leave stale in_progress issues

Integration with Swarm

  1. Claim before editing: Update status before touching code
  2. Document blockers: Create issues for discovered blockers
  3. Handoff cleanly: Update assignee and add context
  4. Sync before ending: bd sync to share state

Troubleshooting

# Check daemon health
bd daemons health

# View daemon logs
bd daemons logs

# Force reimport from JSONL
bd import --force

# Check for conflicts
bd sync --dry-run

Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.

<a href="https://skillzs.dev/skills/dralgorhythm/claude-agentic-framework/beads-workflow">View beads-workflow on skillZs</a>