What is a 'bead' in this context?

A bead is a specific unit of work or task defined in a structured BEADS.md file, which is part of a specialized project planning format used by the bd issue tracker.

How does the skill handle task dependencies?

The skill parses symbolic IDs from your markdown, maps them to the actual IDs generated by the bd tracker, and runs dependency commands to link tasks correctly.

What happens if my BEADS.md file has the wrong format?

The skill includes a validation step that checks for the correct H2 header format and required sections, alerting you to schema errors before creation starts.

Which skills should be used before create-beads?

Ideally, you should use /write-beads to generate the plan file and /bead-review to ensure the tasks and dependencies are accurate before importing.

Will this create duplicate tasks if I run it twice?

No, the skill includes a safety check that looks for existing beads with the same project label and asks for confirmation before proceeding.

Bead Issue Tracker Importer

Name: Bead Issue Tracker Importer
Author: quantfiction

byquantfiction

0•

生产力与工作流

Automates the importation of structured BEADS.md project plans into the bd issue tracker with full dependency mapping.

The create-beads skill streamlines the transition from project planning to execution by converting markdown-based bead definitions into actionable tasks within the bd issue tracker. It handles the entire lifecycle of task creation, including schema validation, duplicate detection, project-specific labeling, and complex dependency mapping. This ensures that project plans are accurately reflected in the developer's task management system without manual entry errors, allowing for immediate project kickoff with correctly sequenced tasks.

主要功能

01Automated BEADS.md parsing and schema validation

02Smart duplicate detection based on project labels

03Detailed status reporting of P0-P3 task distribution

04Bulk project labeling for streamlined task filtering

050 GitHub stars

06Symbolic-to-actual ID mapping for task dependencies

使用场景

01Importing technical backlogs from architectural reviews into actionable tasks

02Synchronizing offline project planning documents with an active development workflow

03Bootstrapping a new software project from a defined roadmap into an issue tracker

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add quantfiction/dotfiles create-beads

For use in Claude.ai and ChatGPT

Download Skill