Can I review the work breakdown before it's created?

Absolutely. The skill includes a dedicated 'Work Breakdown' phase where you can review, split, or merge tasks before any Beads are filed.

Do I need the GitHub CLI installed?

Yes, this skill requires the 'gh' CLI to be installed and authenticated to fetch issue details directly from your repositories.

Beads is a local-first issue tracking system designed to work seamlessly with git and AI-driven development workflows.

Does it support parallel task execution?

Yes, it identifies independent tasks and maps dependencies so you know which items can be worked on simultaneously.

GitHub Issue to Beads Converter

Name: GitHub Issue to Beads Converter
Author: jbdamask

byjbdamask

•

Collaboration Tools

Transforms GitHub issues into structured Beads work items with verifiable acceptance criteria and automated branch management.

This skill provides a comprehensive workflow for transitioning from high-level GitHub issues to granular, actionable work items within the Beads (bd) issue tracking system. It automates the entire planning lifecycle, including issue fetching via the GitHub CLI, isolated git worktree creation, and the decomposition of complex problems into a hierarchical structure of epics, tasks, and sub-tasks. By enforcing objectively verifiable acceptance criteria and explicit dependency mapping, it ensures that project work is perfectly prepared for execution by both human developers and AI agents.

Key Features

01Hierarchical task decomposition into Epics, Tasks, and Sub-tasks

0223 GitHub stars

03Isolated git branch and worktree creation for every issue

04Automated dependency and parallelization mapping

05Automated GitHub issue fetching and context gathering

06Strict enforcement of objectively verifiable acceptance criteria

Use Cases

01Breaking down a bug report into specific, testable remediation steps in Beads

02Converting a complex GitHub feature request into a structured implementation plan

03Standardizing project requirements with mandatory 'Typecheck passes' and 'Tests pass' criteria

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add jbdamask/john-claude-skills issue-to-beads

For use in Claude.ai and ChatGPT

Download Skill