skills.rest
tomzx
tomzxCOMMUNITY
Explore all skills by this author →
WebsiteGitHub

review-issue

Audit GitHub issues for completeness, clarity, and acceptance criteria quality.

5|Updated Jul 25, 2025
Search Tags:#checklist#github#quality#review#issue#triage#acceptance-criteria
One-click install
npx skills add https://github.com/tomzx/agents --skill review-issue-tomzx
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: review-issue
Source: https://github.com/tomzx/agents/tree/main/skills/review-issue
Command: npx skills add https://github.com/tomzx/agents --skill review-issue-tomzx

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Audits a GitHub issue for completeness, clarity, and acceptance criteria quality before development begins.

Core Features & Use Cases

  • Completeness checks across issue types (bug, feature, question, chore) and required metadata
  • Clarity assessment of title and body for unambiguous understanding
  • Acceptance criteria quality evaluation with actionable recommendations
  • Scope assessment to avoid bundling multiple changes
  • Output a structured, ready-to-action report with suggested edits or comments

Quick Start

Review an existing GitHub issue by running the skill on it to generate a structured feedback report.

Frequently Asked Questions about review-issue

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

FAQPage Schema
How do I audit a GitHub issue for completeness before starting development?▼

Audit a GitHub issue for completeness by checking required metadata across bug reports, feature requests, questions, and chores, then generate a structured feedback report with actionable remediation steps.

What is the best way to review acceptance criteria quality in GitHub issues?▼

Review acceptance criteria quality by evaluating issue clarity and scope to avoid bundling multiple changes, producing a structured report that includes suggested edits and actionable recommendations for improvement.

How do I assess GitHub issue clarity and scope for feature requests?▼

Assess GitHub issue clarity and scope by examining the title and body for unambiguous understanding, ensuring the feature request does not bundle multiple changes, and outputting scope findings with suggested comments.

Can I use a checklist to triage GitHub issues across different project types?▼

Yes, you can apply a triage checklist to bug reports, feature requests, questions, and chores across software projects to evaluate completeness, clarity, and acceptance criteria quality before development begins.

What should be included in a GitHub issue review report?▼

A GitHub issue review report should include completeness checks, clarity assessment, acceptance criteria quality evaluation, and scope findings, accompanied by actionable remediation steps and suggested edits or comments.

Why does my GitHub issue review fail to catch incomplete bug reports?▼

Your issue review may miss incomplete bug reports if it lacks a structured checklist for required metadata and clarity assessment, which are necessary to generate actionable remediation feedback.

Related Skills

Explore More Software Engineering Skills→
kapilvirenahujakapilvirenahuja
3

garura:capture

Convert structured issue inputs into type-driven GitHub issues.

Community
Advanced
joi-fairsharejoi-fairshare
1

addressReview

Merge human PR feedback with structured issues and coordinate parallel implementation agents.

Community
Advanced
jugrajsinghjugrajsingh
1

describing-pr

Generate structured Pull Request descriptions from Git diffs and commit history.

Community
Advanced
janewilkinjanewilkin

lint

Lints Python code with ruff and checks types with mypy.

Community
Intermediate