github-issues-from-spec

Parse feature specifications into testable GitHub issues with acceptance criteria.

2|Updated May 2, 2025
One-click install
npx skills add https://github.com/adryanev/.dotfiles --skill github-issues-from-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-issues-from-spec
Source: https://github.com/adryanev/.dotfiles/tree/main/.claude/commands/github-issues-from-spec
Command: npx skills add https://github.com/adryanev/.dotfiles --skill github-issues-from-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Parsing and converting complex feature specifications into actionable work items to streamline planning and development.

Core Features & Use Cases

  • Parses specifications, requirements documents, or plans to identify concrete work items.
  • Chunks large features into small, testable GitHub issues with clear acceptance criteria and templates.
  • Creates issues via gh CLI and associates them with the correct GitHub project, labels, and fields for tracking.
  • Use Case: A product team provides a spec, and this skill generates a ready-to-work backlog in the repository.

Quick Start

Provide the specification source and GitHub project details, then run the skill to generate and create the issues.

Frequently Asked Questions about github-issues-from-spec

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

FAQPage Schema
How do I convert feature specifications into GitHub issues?

To convert feature specifications into GitHub issues, you parse requirements documents to identify concrete work items, chunk large features into small testable tasks, and create them via gh CLI with labels and project field updates.

Can I automatically add acceptance criteria templates to GitHub issues from a spec?

Yes, you can automatically add acceptance criteria templates to GitHub issues by parsing specification documents and generating small, testable work items with clear templates attached directly to the GitHub project.

Does this approach work with gh CLI for project management tracking?

Yes, this spec-to-issues approach works with gh CLI to automate issue creation, associate items with the correct GitHub project, apply labels, and update project fields for full traceability in engineering workflows.

What is the best way to chunk large requirements documents into actionable backlog items?

The best way to chunk large requirements documents into actionable backlog items is to parse the feature specifications, break them into small testable GitHub issues, and ensure traceability across product planning and team collaboration.

Do I need a structured requirements document to generate a GitHub project backlog?

Yes, you need to provide a specification source such as a requirements document or feature plan, along with GitHub project details, to generate and create a ready-to-work backlog in the repository.

Why does parsing complex feature specs into work items streamline development?

Parsing complex feature specs into work items streamlines development by converting detailed plans into small, testable GitHub issues with clear acceptance criteria, ensuring actionable tracking and team alignment in GitHub Projects.