draft-github-issues

What problem does it solve?

This Skill converts unstructured plans or requirements into structured GitHub issue YAML files, saving significant time on manual formatting and ensuring consistency across your project tasks. It helps organize complex projects into manageable, related tasks.

Core Features & Use Cases

• YAML Generation: Creates structured GitHub issue YAML files from various inputs, including plan files, text descriptions, or verbal requirements.
• Technical Context Enrichment: Automatically invokes an analyst subagent to add technical breadcrumbs (primary domain, similar patterns, integration points, gotchas) to complex issues, aiding developers.
• Refinement: Allows for analysis and improvement of drafted YAML, ensuring issue titles are outcome-focused and acceptance criteria are specific and testable.
• Use Case: A product manager provides a detailed feature plan in a Markdown document. Use this Skill to automatically transform that plan into a set of interconnected GitHub issues, complete with technical context for developers, ready for review and publishing.

Quick Start

Draft GitHub issues from the plan file located at docs/plans/new-feature-plan.md Then, refine the generated draft issues in tmp/issues/new-feature-plan-timestamp.yml