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.