issue-creator

Generate atomic GitHub issues from an approved engineering specification.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/pcortes/swarm-attack --skill issue-creator
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-creator
Source: https://github.com/pcortes/swarm-attack/tree/main/default-skills/issue-creator
Command: npx skills add https://github.com/pcortes/swarm-attack --skill issue-creator

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill automates the tedious process of breaking down detailed engineering specifications into atomic, implementable GitHub issues. It saves project managers and developers hours of manual task creation, ensuring comprehensive coverage, clear dependencies, and accurate sizing for development, thereby accelerating project kick-off.

Core Features & Use Cases

  • Automated Issue Generation: Creates well-structured GitHub issues directly from an approved engineering specification.
  • Intelligent Task Decomposition: Breaks down complex features into smaller, manageable tasks with defined dependencies, labels, and estimated sizes.
  • Streamlined Project Planning: Ensures that all aspects of a feature are covered by actionable tasks, ready for assignment and implementation.
  • Use Case: An approved engineering spec for "User Authentication" is ready. This Skill automatically generates a series of GitHub issues like "Create User model", "Implement password hashing utilities", and "Create registration endpoint", complete with descriptions, acceptance criteria, and dependencies.

Quick Start

Generate a list of atomic GitHub issues from the approved engineering specification at 'specs/user-auth/spec-draft.md', including dependencies and estimated sizes.

Frequently Asked Questions about issue-creator

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

FAQPage Schema
How do I break down a software specification into GitHub issues?

Breaking down specifications into GitHub issues involves decomposing a detailed spec into atomic, independently implementable tasks with clear dependencies and size estimates. This Skill automates that process by generating well-structured issues directly from an approved engineering specification, complete with acceptance criteria and dependency mappings.

Can I automatically generate GitHub issues with dependencies and size estimates from a spec?

Yes. This Skill generates atomic GitHub issues from approved engineering specifications, including estimated sizes, dependency chains validated as a DAG, labels, and explicit acceptance criteria for each task, eliminating manual issue creation.

What's the best way to ensure comprehensive task coverage when planning an engineering project?

Automated task decomposition from a detailed spec ensures all feature aspects are covered by actionable tasks with clear dependencies. This Skill breaks down complex features into independently implementable units with defined ordering and prerequisites, accelerating project kick-off and reducing planning gaps.

How does task decomposition handle dependencies between GitHub issues?

This Skill validates dependencies as a directed acyclic graph (DAG), establishing clear predecessor-successor relationships between issues so teams understand task sequencing and can parallelize independent work while respecting ordering constraints.

Can I use this for agile project planning and issue management?

Yes. The Skill generates labeled, sized issues with explicit acceptance criteria and dependency metadata, fitting agile workflows where issues are assigned, tracked, and sized for sprint planning and iterative development.

What input format does the specification need to be in?

The Skill accepts approved engineering specifications in Markdown format (e.g., `specs/user-auth/spec-draft.md`). It parses detailed requirements and automatically generates structured GitHub issues with all metadata needed for implementation.