make-issue-spec

Create a markdown document that describes a specific task along with

⭐932stars🔀70forks📁View on GitHub🕐Updated Jan 4, 2026

When & Why to Use This Skill

The skill automates the creation of standardized technical issue specifications in Markdown format. It streamlines the transition from a vague idea to a structured project document by generating detailed task descriptions and concise implementation plans, automatically organized by date and staged in Git for version control.

Use Cases

  • Technical Task Documentation: Automatically generating detailed specifications for new features or bug fixes to ensure all requirements are captured before development starts.
  • Implementation Planning: Drafting structured, step-by-step technical plans that outline exactly how a specific task should be executed to maintain team alignment.
  • Git-Integrated Workflow: Seamlessly staging requirement documents directly into a repository to maintain a version-controlled history of project specifications and decisions.
  • Requirement Refinement: Using the agent's interactive prompting to identify and fill gaps in underspecified tasks, ensuring comprehensive and actionable documentation.
namemake-issue-spec
descriptionCreate a markdown document that describes a specific task along with

make-issue-spec

There isn't a lot more to this than what the top level description says. The idea is for this issue spec to contain a clear specification of what is needed. Make sure to ask the user any questions for parts that you're not sure of or are under specified. Stage this in Git if you have permissions.