skills.rest
codekiln
codekilnCOMMUNITY
Explore all skills by this author →
Website𝕏@codekilnGitHub

github-issue-breakdown

Parse GitHub issue task lists and create linked sub-issues via the GraphQL API.

3|Updated Oct 25, 2025
Search Tags:#automation#project management#github#issues#epic#task lists#sub-issues
One-click install
npx skills add https://github.com/codekiln/langstar --skill github-issue-breakdown
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: github-issue-breakdown
Source: https://github.com/codekiln/langstar/tree/main/.claude/skills/github-issue-breakdown
Command: npx skills add https://github.com/codekiln/langstar --skill github-issue-breakdown

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires gh, and includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation of official GitHub sub-issues from task lists within a parent issue's description. It prevents the common mistake of creating manual, informal links that lack GitHub's native hierarchy features, saving you time and ensuring accurate project tracking.

Core Features & Use Cases

  • Automated Sub-Issue Creation: Parses various task list formats (checkboxes, numbered, bullets) from parent issue descriptions and creates properly linked sub-issues via the GitHub GraphQL API.
  • Metadata Inheritance: Sub-issues automatically inherit labels and assignees from the parent issue, reducing manual setup.
  • Use Case: After creating an Epic issue with a detailed task list like "Implement login endpoint" and "Create registration endpoint", use this skill to instantly convert these into properly linked GitHub sub-issues, ensuring accurate project tracking.

Quick Start

Break down issue #42 into sub-tasks, automatically confirming the creation of the sub-issues.

Frequently Asked Questions about github-issue-breakdown

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

FAQPage Schema
How do I convert GitHub issue task lists into official sub-issues?▼

This Skill parses task lists (checkboxes, numbered, or bullet formats) from a parent issue's description and automatically creates properly linked sub-issues via GitHub's GraphQL API. It transforms informal task lists into GitHub's native sub-issue hierarchy, ensuring accurate project tracking without manual linking.

Can I automatically inherit labels and assignees when creating sub-issues from an epic?▼

Yes. When breaking down a parent issue into sub-issues, the Skill automatically inherits labels and assignees from the parent issue to each created sub-issue, eliminating manual metadata setup and keeping related work consistently tagged across your project.

What task list formats does this Skill support for parsing sub-issues?▼

The Skill parses multiple task formats including checkboxes, numbered lists, and bullet points from issue descriptions. This flexibility lets you use your preferred formatting style when writing epics or multi-step tasks, and the Skill handles the breakdown regardless of structure.

Do I need to confirm sub-issue creation, or can it run automatically?▼

The Skill supports both modes: interactive confirmation for review before creation, or automatic confirmation to skip the preview step. You control the workflow depending on whether you want to validate proposed sub-issues first or proceed immediately.

Can I preview sub-issues before they're created in GitHub?▼

Yes. The Skill generates a preview of proposed sub-issues so you can review the parsed tasks and proposed structure before committing. This dry-run capability prevents unintended sub-issue creation and lets you refine the task breakdown.

Does this work with existing issues or only newly created epics?▼

You can break down any GitHub issue containing task lists—whether created moments ago or previously. Specify the issue number to convert its task list into sub-issues at any time, making it flexible for both immediate and retroactive breakdowns.

Related Skills

Explore More Product & Management Skills→
tomoasleeptomoasleep
2

create-github-sub-issues

Create, list, and remove GitHub Sub Issues under a parent issue.

Community
Intermediate
oletizioletizi

feature-issues

Create GitHub parent and per-phase issues from completed workplans.

Community
Intermediate
anyeloamtanyeloamt

gh-pr-issue-workflow

Automates GitHub issue and PR creation with sub-issue linking.

Community
Advanced
codekilncodekiln
3

gh-sub-issue

Link GitHub issues as parent-child sub-issues via the GitHub API.

Community
Intermediate