github-issue-breakdown
Installation
SKILL.md
GitHub Issue Breakdown
Overview
This skill automates breaking down GitHub issues into official GitHub sub-issues using the GitHub GraphQL API. It parses various task list formats from parent issue descriptions, shows a preview of proposed sub-issues, and creates them with proper parent-child relationships while inheriting metadata like labels and assignees.
When to Use This Skill
⚠️ CRITICAL: Use this skill IMMEDIATELY after creating an Epic/parent issue with a task list!
DO NOT manually create sub-issues - they won't have proper GitHub parent-child relationships and won't show in the sub-issue UI.
Use this skill when:
- Right after creating an Epic - Run this immediately to create official sub-issues ⭐ MOST IMPORTANT
- User requests breaking down an issue into sub-tasks (e.g., "break down issue #47 into sub-issues")
- User mentions converting a task list into sub-issues
- User is working with complex features that need hierarchical task management
- User needs to create multiple related child issues from a parent issue