What are the requirements to use this skill?

You must be working within a git repository that has an initialized .beads directory, and your environment must have the bd CLI and jq installed.

What file format does tasks2issues support?

It specifically parses the SpecKit markdown format, which utilizes specific header patterns for phases and user stories, alongside markdown checkboxes for tasks and priority tags.

Can I preview the issues before they are created in Beads?

Yes, by using the --dry-run flag, the skill will parse the file, validate the syntax, and show you the intended mapping without making any changes to your issue tracker.

Where does the skill look for the tasks.md file?

If no file is specified, it automatically checks the specs/ directory for a folder matching your current git branch, then searches general spec paths and the root directory.

Does it handle complex task dependencies?

Absolutely. The skill recognizes 'Depends on' declarations and automatically converts them into Beads blocks/blocked-by relationships, ensuring your critical path is maintained.

Tasks to Beads Issues Converter

Name: Tasks to Beads Issues Converter
Author: kbrockhoff

bykbrockhoff

0•

协作工具

Automates the conversion of SpecKit-formatted task lists into structured Beads issue tracking entries with full dependency support.

This skill streamlines the project management workflow by parsing SpecKit-generated tasks.md files and automatically creating corresponding issues in the Beads tracking system. It preserves complex metadata including phase headers, user story grouping, priority levels (P0-P4), and task dependencies. By automating the transition from technical specification to actionable tickets, it ensures project structures remain consistent and valid while saving developers from the overhead of manual issue creation.

主要功能

01Preservation of multi-level hierarchies including phases and user stories

02Automated dependency management using blocks and blocked-by relationships

03Dry-run validation mode to detect syntax errors and circular dependencies

04Automatic detection of tasks.md files based on branch context or project structure

050 GitHub stars

06Smart mapping of task priorities (P0-P4) to Beads-specific priority levels

使用场景

01Synchronizing architectural planning documents with internal issue tracking systems

02Converting high-level technical specifications into granular, trackable work items

03Validating task dependency chains to prevent project bottlenecks before execution

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add kbrockhoff/brockhoff-tools-claude tasks2issues

For use in Claude.ai and ChatGPT

Download Skill