skills.rest
elsolal
elsolalCOMMUNITY
Explore all skills by this author →
GitHub

github-issue-reader

Analyze GitHub issues and extract requirements, acceptance criteria, and context.

1|Updated Jan 20, 2026
Search Tags:#workflow#requirements#GitHub#PRD#issue#analyze#acceptance-criteria
One-click install
npx skills add https://github.com/elsolal/Skillz-Claude --skill github-issue-reader-elsolal
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: github-issue-reader
Source: https://github.com/elsolal/Skillz-Claude/tree/main/.claude/skills/github-issue-reader
Command: npx skills add https://github.com/elsolal/Skillz-Claude --skill github-issue-reader-elsolal

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill reads and analyzes a GitHub issue to extract requirements, acceptance criteria, and context, enabling teams to start work with precise guidance when initiating features, fixing bugs, or planning tasks.

Core Features & Use Cases

  • Data extraction: Pulls issue title, body, labels, assignees, milestone, and all comments, plus linked pull requests and related issues.
  • Clarification & structuring: Identifies ambiguities, classifies the issue type (feature, bug, refactor) and outputs standardized requirements and acceptance criteria.
  • Context preservation: Retains the link to the original issue for traceability and auditability, supporting PRDs and planning workflows.

Quick Start

To analyze an issue, provide its number or URL to the Skill. The tool will fetch the issue, extract relevant metadata, and return a structured, ready-to-use output describing requirements, acceptance criteria, and any questions or ambiguities.

Frequently Asked Questions about github-issue-reader

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

FAQPage Schema
How do I extract acceptance criteria from a GitHub issue?▼

This tool translates GitHub issues into actionable requirements by classifying the issue type (feature, bug, refactor) and extracting context like labels, assignees, and milestones. It produces standardized functional requirements, acceptance criteria, and notes on ambiguities or dependencies.

Can I generate functional requirements from a GitHub issue containing linked pull requests?▼

You can start analyzing an issue by providing its number or URL. The tool fetches the issue, extracts relevant metadata like assignees and milestones, and returns a ready-to-use structured output detailing requirements, acceptance criteria, and any questions or ambiguities.

Does this tool work with GitHub issues for both new features and refactoring tasks?▼

Yes, it works with GitHub issues for new features, bug fixes, and refactoring tasks. It classifies the issue type automatically and retains the original issue link to support product requirement documents and planning workflows.

What is the best way to identify ambiguities and dependencies in GitHub issue descriptions?▼

The best way to identify ambiguities and dependencies in GitHub issue descriptions is to run them through this analysis tool. It extracts context from comments and linked issues, outputting specific notes on missing information and dependencies.

Related Skills

Explore More Software Engineering Skills→
tomholfordtomholford
6

view-issue

... (see below)

Community
Intermediate
bearbinarybearbinary

prd-to-json

Converts Markdown PRDs into structured JSON task files with progress tracking.

Official
Intermediate
lluppesmslluppesms

github-issues

Create, update, and manage GitHub issues via MCP tools.

Community
Intermediate
gioegioe

address-issue

Convert GitHub issues into tusk tasks with acceptance criteria.

Community
Advanced