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.