beads-schema

Define Beads CLI issue types, statuses, priorities, and dependencies.

91|9|Updated Dec 24, 2025
One-click install
npx skills add https://github.com/GantisStorm/essentials-claude-code --skill beads-schema
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: beads-schema
Source: https://github.com/GantisStorm/essentials-claude-code/tree/main/essentials/skills/beads-schema
Command: npx skills add https://github.com/GantisStorm/essentials-claude-code --skill beads-schema

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Beads CLI reference provides a centralized guide to issue types, statuses, priorities, dependencies, and common commands for the Beads workflow.

Core Features & Use Cases

  • Defines core bead types (task, bug, feature, epic) and statuses, with JSON field mappings and CLI usage tips.
  • Outlines how to convert architectural plans into beads via the converter, and how to manage dependencies and ready states.
  • Use Case: Create an epic and child tasks with proper dependency links to drive project progress.

Quick Start

Run the beads reference to verify the Beads CLI is properly configured and ready for creation and management of beads.

Frequently Asked Questions about beads-schema

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

FAQPage Schema
How do I standardize issue tracking and workflow management in a git-backed workspace?

Standardize issue tracking by defining core issue types, statuses, priorities, and dependencies. This approach ensures consistent creation and management of tasks within a git-backed workspace.

What are the standard issue types and statuses for the Beads CLI workflow?

The standard issue types for the Beads workflow include task, bug, feature, and epic. These types map to specific JSON fields to drive consistent project planning and dependency management.

How do I create an epic and assign dependencies to child tasks?

Create an epic and child tasks using CLI commands to establish proper dependency links. This drives project progress by managing ready states and linking related issues together.

Can I convert architectural plans into trackable issues for project management?

Yes, convert architectural plans into trackable issues via the converter. This enables you to manage dependencies and ready states directly within your project management workflow.

Does the Beads CLI require any external dependencies for issue creation?

No external dependencies are required to use the Beads CLI for issue creation. It operates independently to define bead types, statuses, and commands for your workflow.

What is the best way to verify that the Beads CLI is properly configured?

Run the beads reference command to verify the CLI is properly configured. This checks that your environment is ready for the creation and management of beads.