github-issues

Create structured GitHub issues with acceptance criteria, dependencies, and milestones.

Updated Jan 4, 2026
One-click install
npx skills add https://github.com/shwilliamson/a-test --skill github-issues-shwilliamson
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: github-issues
Source: https://github.com/shwilliamson/a-test/tree/main/.automatasaurus/skills/github-issues
Command: npx skills add https://github.com/shwilliamson/a-test --skill github-issues-shwilliamson

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This skill provides guidance for breaking work into well-scoped GitHub issues, ensuring consistent sizing and milestone planning during discovery and planning phases.

Core Features & Use Cases

  • One PR Per Issue: each issue should be self-contained and completable in a single pull request.
  • Vertical Slices: prioritize end-to-end functionality over isolated refactors.
  • Testable Acceptance Criteria: every issue includes objectively verifiable criteria.
  • Dependencies & Milestones: clearly declare dependencies and align work with milestones.
  • Templates & Consistency: leverage standard issue templates to maintain uniformity across projects.

Quick Start

Create your first issue by following the provided user-story template, define acceptance criteria, list any dependencies, and assign an appropriate milestone. Use the issue template to ensure consistency across the project.

Frequently Asked Questions about github-issues

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

FAQPage Schema
How do I break down project work into well-structured GitHub issues?▼

To break down project work into well-structured GitHub issues, you should follow standard issue templates that enforce vertical slices, single pull request sizing, and objectively testable acceptance criteria for each task.

How do I write testable acceptance criteria for GitHub issue templates?▼

Testable acceptance criteria for GitHub issue templates should be objectively verifiable conditions that define task completion, ensuring every issue remains self-contained and completable within a single pull request.

What is the best way to manage dependencies and milestones for GitHub issues?▼

The best way to manage dependencies and milestones for GitHub issues is to explicitly declare prerequisite issues within the template and align each task with a targeted project milestone during the planning phase.

Should GitHub issues be scoped for one pull request per issue?▼

Yes, scoping one pull request per GitHub issue ensures each task is self-contained and prioritizes end-to-end vertical slices over isolated refactors, maintaining consistent sizing across the project.

When should I use vertical slices instead of isolated refactors in GitHub milestones?▼

You should use vertical slices instead of isolated refactors in GitHub milestones during the discovery and planning phases to prioritize delivering end-to-end functionality within a single issue cycle.

Does this GitHub issue structuring approach work for discovery and planning phases?▼

Yes, this approach standardizes task decomposition for software projects specifically during discovery and planning phases by providing templates, dependency management, and milestone guidance to scope work.