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.