issue-workflow

Decompose specifications into GitHub issues with standardized templates and .issue/ documentation.

Updated Aug 23, 2026
One-click install
npx skills add https://github.com/nishio-n0522/test_updated_sdd --skill issue-workflow-nishio-n0522
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: issue-workflow
Source: https://github.com/nishio-n0522/test_updated_sdd/tree/main/.claude/skills/issue-workflow
Command: npx skills add https://github.com/nishio-n0522/test_updated_sdd --skill issue-workflow-nishio-n0522

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This Skill provides a structured methodology and clear formats for breaking down complex specifications into manageable GitHub issues and organizing their detailed documentation within the .issue/ directory.

Core Features & Use Cases

  • Issue Decomposition: Defines a clear process for splitting work into independent, testable units.
  • Standardized Formatting: Offers templates for GitHub issue bodies and detailed .issue/spec.md files.
  • Directory Structure Convention: Establishes a consistent way to store issue-specific documentation.
  • Use Case: When a new feature is defined in a PRD, this Skill helps an AI agent systematically create individual GitHub issues for each component, ensuring all necessary details are captured and organized for development.

Quick Start

Use the issue-workflow skill to decompose the provided specification document into GitHub issues and their corresponding .issue/ directory structures.

Frequently Asked Questions about issue-workflow

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

FAQPage Schema
How do I decompose a specification document into GitHub issues?

Decomposing specifications into GitHub issues involves splitting work into independent, testable units using standardized templates for issue bodies and detailed `.issue/spec.md` files to capture all necessary documentation.

What is the best way to organize detailed documentation for project management in GitHub?

Organizing project management documentation is best handled by establishing a consistent `.issue/` directory structure convention, storing detailed issue-specific documentation alongside standardized GitHub issue bodies.

How do I manage issue dependencies and granularity when tracking work on GitHub?

Managing issue dependencies and granularity requires a methodology that splits specifications into manageable units and enforces quality through mandatory checklist items for issue decomposition and documentation.

Can I use standardized templates for GitHub issue bodies and spec files?

Yes, you can use standardized templates for GitHub issue bodies and `.issue/` directory files to systematically capture component details, ensuring necessary documentation is consistently organized for development.

When do I need a structured workflow for breaking down complex specifications?

You need a structured workflow for breaking down complex specifications when a new feature is defined in a PRD and an AI agent must systematically create individual GitHub issues for each component while ensuring quality through mandatory checklists.

Does issue-workflow require any specific dependencies to decompose issues?

No, issue-workflow has no external dependencies; it provides a standalone methodology and standardized formats for decomposing specifications into GitHub issues and organizing `.issue/` documentation without requiring additional tools.