What problem does it solve? Turning vague ideas or approved specs into well-scoped, trackable GitHub issues is time-consuming and error-prone. This Skill structures issue creation, refinement, backlog organization, and spec-to-issue decomposition so every work item has clear scope, testable acceptance criteria, and proper dependency wiring. ## Core Features & Use Cases - Issue Shaping: Create new issues or refine existing ones with action-oriented titles, acceptance criteria, scope boundaries, labels, and milestones via the GitHub CLI. - Spec Decomposition (--from-spec): Parse an approved spec file, identify vertical slices, and generate a parent spec issue plus sub-issues with blocked-by relationships and project board fields. - Backlog & Milestone Organization: Assess milestone groups for scope clarity, dependency completeness, and ordering, then propose restructuring. - Use Case: After a design spec is approved, run the skill with --from-spec to automatically produce a tracked spec issue and a set of independent, testable sub-issues linked to the milestone. ## Quick Start Ask the assistant to decompose the approved spec at docs/specs/my-feature.md into GitHub issues using forge-shape.
