Beads Workflow Skill

Manage project tasks with the bd command-line tool and JSONL sync.

1|Updated Nov 20, 2025
One-click install
npx skills add https://github.com/liveview-native/swiftui-modifiers-codegen --skill beads-workflow-skill
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: Beads Workflow Skill
Source: https://github.com/liveview-native/swiftui-modifiers-codegen/tree/main/skills/beads_workflow
Command: npx skills add https://github.com/liveview-native/swiftui-modifiers-codegen --skill beads-workflow-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a robust, Git-friendly system for managing all project tasks, ensuring a single source of truth and preventing confusion from scattered tracking methods.

Core Features & Use Cases

  • Comprehensive Task Management: Create, update, track, and close issues using the bd command-line tool.
  • Dependency Tracking: Link issues using discovered-from to maintain traceability and understand blockers.
  • Git Integration: Automatically syncs issue status to .beads/issues.jsonl, which is committed with your code.
  • AI Agent Optimization: Provides JSON output for programmatic use by AI agents.
  • Use Case: When starting a new work session, you can instantly see what tasks are unblocked and ready to be worked on by running bd ready --json.

Quick Start

Check for any unblocked tasks that are ready to be worked on by running the command bd ready --json.

Frequently Asked Questions about Beads Workflow Skill

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

FAQPage Schema
How do I track project tasks and issues directly in Git?▼

Track project tasks in Git by using the `bd` command-line tool to manage issues and automatically synchronize status updates to a version-controlled `.beads/issues.jsonl` file.

What is the best way to manage task dependencies and blockers for AI agents?▼

The best way to manage task dependencies for AI agents is linking issues via `discovered-from` and using `bd ready --json` to output unblocked tasks, providing a programmatic JSON format for immediate AI consumption.

How do I see which tasks are ready to be worked on during a new session?▼

You can see which tasks are ready to be worked on by running the `bd ready --json` command, which outputs unblocked issues in JSON format for quick visibility into actionable project items.

Does the beads workflow tool support priority management and status updates?▼

Yes, the beads workflow tool supports comprehensive task management including issue creation, status updates, and priority management, enforcing a single source of truth to prevent confusion from scattered tracking methods.

Can I use command-line issue tracking without an external database or server?▼

Yes, you can use command-line issue tracking without external infrastructure because `bd` stores all issue data locally in a `.beads/issues.jsonl` file, making it fully compatible with Git repositories and AI agents.

Why use a JSONL file for project management and issue tracking?▼

Using a JSONL file for issue tracking ensures a Git-friendly, single source of truth that is easily diffable in version control while providing JSON output optimized for programmatic access by AI agents.