review-issues

Audit GitHub issues for clarity, completeness, and project standards.

1|Updated Mar 12, 2026
One-click install
npx skills add https://github.com/ourchitecture/idp --skill review-issues-ourchitecture
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: review-issues
Source: https://github.com/ourchitecture/idp/tree/main/.agents/skills/review-issues
Command: npx skills add https://github.com/ourchitecture/idp --skill review-issues-ourchitecture

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Reviews GitHub Issues for completeness, clarity, and adherence to repository standards to ensure issues are ready for triage and implementation.

Core Features & Use Cases

  • Validate issue titles for clarity and descriptiveness.
  • Validate issue bodies for context, motivation, acceptance criteria, labels, and scope.
  • Generate per-issue findings with severity and actionable recommendations; compute overall health and scores to guide triage decisions.

Quick Start

Run the review-issues skill to audit all open issues or a specific issue to surface quality findings.

Frequently Asked Questions about review-issues

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

FAQPage Schema
How do I audit GitHub issues for quality and readiness?

To audit GitHub issues for quality, the skill validates issue titles and bodies for context, motivation, and acceptance criteria, then returns structured findings with per-issue scores and an overall status to guide triage.

What does an automated GitHub issue review check for?

An automated GitHub issue review checks for clarity in titles, completeness in issue bodies, and adherence to repository standards by applying priority, domain, and acceptance-criteria checks with optional label filters.

Can I filter GitHub issues by labels when checking triage readiness?

Yes, you can apply optional label filters when auditing GitHub issues, allowing the review process to target specific subsets of open issues and return focused findings with severity and actionable recommendations.

How do I get a health score for open GitHub issues to guide planning?

To get a health score for open GitHub issues, the skill computes per-issue findings and overall health scores based on clarity, completeness, and project standard adherence, returning issue counts to guide planning.

Does automated issue triage work on a specific GitHub issue or all open issues?

Automated issue triage operates on either all open issues or a specified single issue, applying priority and acceptance-criteria checks to generate actionable recommendations and an overall readiness status.

What is the best way to ensure GitHub issues meet project standards before implementation?

The best way to ensure GitHub issues meet project standards is to audit them for clarity, completeness, and scope, generating per-issue findings with severity levels to verify they are ready for triage and implementation.