skills.rest
ImperialAutomation
ImperialAutomationOFFICIAL
Explore all skills by this author →
WebsiteGitHub

decompose

Break down complex GitHub issues into sub-issues and a tracking draft PR.

11|3|Updated Jan 29, 2026
Search Tags:#project management#github#task breakdown#issue tracking#sub-issues#issue decomposition
One-click install
npx skills add https://github.com/ImperialAutomation/claude-code-toolkit --skill decompose-imperialautomation
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: decompose
Source: https://github.com/ImperialAutomation/claude-code-toolkit/tree/main/skills/decompose
Command: npx skills add https://github.com/ImperialAutomation/claude-code-toolkit --skill decompose-imperialautomation

SYSTEM DOCUMENTATION & REQUIREMENTS

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

What problem does it solve?

This Skill simplifies the process of dividing complex GitHub issues into smaller, trackable sub-issues, streamlining project management and progress tracking.

Core Features & Use Cases

  • Issue Analysis: Fetches and analyzes large issues to identify major phases, dependencies, and logical groupings.
  • Breakdown Proposal: Presents a structured table of sub-issues with dependencies for user review.
  • Draft Issue and PR Creation: Automates generation of sub-issue skeletons and a draft tracking pull request, coordinating multiple related issues.
  • Integration: Links sub-issues to the parent issue as native GitHub sub-issues for clear hierarchical tracking.
  • Use Case: For large feature development, systematically decompose a far-reaching issue to parallelize work and monitor progress effectively.

Quick Start

Use the decompose skill with an issue number to automatically analyze and create sub-issues for that issue.

Frequently Asked Questions about decompose

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

FAQPage Schema
How do I break down large GitHub issues into manageable sub-issues?▼

You can break down large GitHub issues into manageable sub-issues by automating issue analysis to identify major phases, dependencies, and logical groupings, then generating sub-issue skeletons and a tracking draft pull request.

What is the best way to automate task breakdown for complex feature development?▼

The best way to automate task breakdown for complex feature development is to programmatically analyze the parent issue, present a structured dependency table for review, and automatically link native GitHub sub-issues for clear hierarchical tracking.

How does issue decomposition handle dependencies when creating sub-issues?▼

Issue decomposition handles dependencies by fetching and analyzing the large issue to identify logical groupings, then presenting a structured table of proposed sub-issues with their specific dependencies mapped out for user review.

Do I need GitHub CLI tools to decompose project issues?▼

Yes, you need GitHub CLI tools to decompose project issues, because the process requires repository context and programmatic access to analyze existing issues and automatically create new sub-issues.

Can I review the proposed sub-issues before they are created on GitHub?▼

Yes, you can review the proposed sub-issues before they are created on GitHub, because the breakdown process presents a structured table of sub-issues and their dependencies for user review prior to draft issue and PR creation.

Related Skills

Explore More Software Engineering Skills→
theZMCtheZMC
2

read-github-issue

Read GitHub issue status, metadata, and comments via gh CLI.

Community
Intermediate
sasamukusasamuku
8

summarize-epic

Generate summaries of GitHub Epic issues with sub-issues and pull requests.

Community
Advanced
qauth-labsqauth-labs
23

add-sub-issue

Create parent-child sub-issue relationships between GitHub issues via GraphQL mutations.

Official
Basic
softsparksoftspark
161

architecture-audit

Analyze codebases to identify shallow modules and prepare RFC GitHub issues.

Community
Advanced