speckit-phasestoissues

Convert development phases from specification files into labeled GitHub issues with sub-issues.

Updated Mar 13, 2026
One-click install
npx skills add https://github.com/refactory-lang/refactory-template --skill speckit-phasestoissues
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: speckit-phasestoissues
Source: https://github.com/refactory-lang/refactory-template/tree/main/.claude/skills/speckit-phasestoissues
Command: npx skills add https://github.com/refactory-lang/refactory-template --skill speckit-phasestoissues

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill automates the creation of GitHub issues from development phases defined in your project's specification files, streamlining task management and improving team visibility.

Core Features & Use Cases

  • Automated Issue Creation: Generates GitHub issues for each development phase.
  • Task Breakdown: Converts tasks from tasks.md into sub-issues.
  • Contextual Information: Includes phase description, acceptance criteria, and implementation plan in issues.
  • Labeling: Automatically applies relevant labels based on workflow type and priority.
  • Use Case: After defining a new feature in your spec.md, run this Skill to create a parent GitHub issue for the phase and individual sub-issues for each task, all linked and properly labeled.

Quick Start

Use the speckit-phasestoissues skill to convert the current development phase into GitHub issues.

Frequently Asked Questions about speckit-phasestoissues

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

FAQPage Schema
How do I create GitHub issues from development specification files?

You can create GitHub issues from specification files by using a tool to parse phase definitions and task lists, automatically generating parent issues and linked sub-issues with contextual labels based on your Git repository context.

Can I automatically break down project phases into GitHub sub-issues?

Yes, you can automatically break down project phases into GitHub sub-issues by extracting tasks from your specification files. Each task is converted into a linked sub-issue under a parent phase issue, streamlining development workflow management.

How do I add acceptance criteria and implementation plans to GitHub issues automatically?

To add acceptance criteria and implementation plans to GitHub issues automatically, use an automation tool that reads your specification files and embeds the phase descriptions and contextual details directly into the generated issue bodies.

Does generating GitHub issues from spec files require Git repository access?

Yes, generating GitHub issues from specification files requires Git repository access. The automation relies on your current Git context and project structure to correctly extract phases, apply relevant labels, and link the generated issues.

What is the best way to automate task management issue labeling from project specifications?

The best way to automate task management issue labeling from project specifications is to use a script that reads your workflow type and priority directly from the spec files, automatically applying the relevant labels during GitHub issue creation.

When should I avoid automating GitHub issue creation from development phases?

You should avoid automating GitHub issue creation from development phases if your project lacks structured specification files with defined phases and tasks, or if your repository does not have the Git context necessary for proper issue linking and labeling.