github-issue-spec

Draft GitHub issues with structured spec templates for problems, criteria, and dependencies.

3|Updated Jul 5, 2021
One-click install
npx skills add https://github.com/iAziz786/dotfiles --skill github-issue-spec
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: github-issue-spec
Source: https://github.com/iAziz786/dotfiles/tree/main/.agents/skills/github-issue-spec
Command: npx skills add https://github.com/iAziz786/dotfiles --skill github-issue-spec

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill helps users convert vague requests into well-structured GitHub issues by applying a standard spec template, ensuring clarity and traceability.

Core Features & Use Cases

  • Structured templates for issue bodies with sections like Problem, Acceptance Criteria, Edge Cases & Exclusions, and Dependencies.
  • Ambiguity resolution before drafting to reduce back-and-forth and rework.
  • Template-driven outputs ready to copy into GitHub issues or planning documents.

Quick Start

Draft a GitHub issue spec for adding a dark mode toggle to the app.

Frequently Asked Questions about github-issue-spec

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

FAQPage Schema
How do I draft a GitHub issue spec from natural language?

To draft a GitHub issue spec from natural language, you provide a plain text description of a feature or bug, and the skill generates a structured template capturing problems, acceptance criteria, edge cases, and dependencies.

What is a structured GitHub issue template and when do I need one?

A structured GitHub issue template standardizes planning artifacts by enforcing sections for problems, acceptance criteria, and dependencies. You need a spec-style issue when ambiguity exists in feature requests or bug reports to ensure clarity and prioritization.

How do I write acceptance criteria and edge cases for a GitHub feature request?

Writing acceptance criteria and edge cases for a GitHub feature request involves applying a template-driven format that explicitly lists required conditions as a checklist and defines exclusions to reduce back-and-forth before development begins.

Can I use this to plan tasks and resolve ambiguity before creating GitHub issues?

Yes, you can use this to plan tasks and resolve ambiguity before creating GitHub issues. It converts vague requests into well-structured planning artifacts with defined frontmatter and traceable dependencies, reducing rework.

What is the best way to format bug reports for GitHub prioritization?

The best way to format bug reports for GitHub prioritization is using a spec-style template that captures the problem, acceptance criteria, and edge cases. This structured approach ensures clarity and traceability for maintainers.