beads-workflow

Coordinate and track work items with Beads commands and GitHub integration.

111|18|Updated Dec 17, 2025
One-click install
npx skills add https://github.com/dralgorhythm/claude-agentic-framework --skill beads-workflow-dralgorhythm
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads-workflow
Source: https://github.com/dralgorhythm/claude-agentic-framework/tree/main/.claude/skills/operations/beads-workflow
Command: npx skills add https://github.com/dralgorhythm/claude-agentic-framework --skill beads-workflow-dralgorhythm

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Coordinates beaded work items across agents, linking GitHub PRs, and syncing state via Beads.

Core Features & Use Cases

  • Beads Commands: Create, list, show, update, close issues.
  • Dependencies: Model task blocks and readiness.
  • Use Case: Track a feature ticket across agents with dependencies.

Quick Start

Create an issue and link it to a PR in GitHub for visibility.

Frequently Asked Questions about beads-workflow

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I coordinate work items across multiple agents with GitHub integration?

Beads is an AI-native issue tracker that coordinates work items across agents by creating, tracking, and syncing issues with GitHub PRs. Use bd create to open issues, bd dep add to model task dependencies, and bd sync to keep state synchronized across agents and repositories.

Can I track task dependencies and readiness in multi-agent workflows?

Yes. Beads models task blocks and readiness through dependency management. Use bd dep add to establish dependencies between issues, bd dep tree to visualize the dependency graph, and bd dep rm to remove blocking relationships as work progresses.

What's the best way to manage issue status and visibility across teams?

Beads supports status workflow and team-visibility patterns through command-based CRUD operations. Use bd list to view all issues, bd show to inspect details, bd update to change status, and bd close to mark work complete, ensuring all agents see current state.

How do I synchronize Beads issues with GitHub PRs?

Link Beads issues to GitHub PRs for unified visibility. Use bd create to establish an issue, then reference the GitHub PR in the issue details. Run bd sync to pull changes from GitHub and bd flush to push Beads state back, maintaining consistency across platforms.

Can Beads handle handoffs between agents in a workflow?

Yes. Beads coordinates handoffs across agents through dependency tracking and status updates. Model task sequence with bd dep add, update issue ownership with bd update, and use bd list to ensure receiving agents see incoming work with full context and dependencies.