autospec-review

Audit design specifications against GitHub issues to detect missing requirements and generate regression issues.

3|1|Updated Apr 29, 2026
One-click install
npx skills add https://github.com/berlinguyinca/autospec --skill autospec-review
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: autospec-review
Source: https://github.com/berlinguyinca/autospec/tree/main/skills/autospec-review
Command: npx skills add https://github.com/berlinguyinca/autospec --skill autospec-review

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

Audits design specs against both open and closed GitHub issues to uncover missing requirements, half-finished deliverables, and scope drift before implementation proceeds.

Core Features & Use Cases

  • Spec-to-issue gap detection: Links each design spec to related issues and identifies gaps using a formal taxonomy.
  • Regression issue filing: Writes a per-run CSV ledger of gaps and creates high-priority [REGRESSION] issues when warranted.
  • Reviewer-validated remediation loop: Runs an additional reviewer pass to reduce false positives, tightens acceptance criteria, and routes work through /autospec-split.

Quick Start

Run /autospec-review --since 2026-05-01 --remediation to audit all specs from May 1 onward, emit gap findings, and generate the regression issue queue.

Frequently Asked Questions about autospec-review

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

FAQPage Schema
How do I find missing requirements and gaps between design specs and GitHub issues?

Spec gap detection audits design specifications against linked open and closed GitHub issues using a formal taxonomy to identify missing requirements, inconsistent deliverables, and scope drift before implementation proceeds. It links each spec to related issues and classifies gaps systematically.

How do I automatically file regression issues for spec gaps found in GitHub?

Regression issue filing writes a per-run CSV ledger of discovered gaps and creates high-priority [REGRESSION] issues when warranted. It runs a reviewer-validated remediation pass to reduce false positives and tightens acceptance criteria before routing work back through the issue queue.

Can I audit closed GitHub issues against design specs to catch half-finished deliverables?

Yes, spec auditing evaluates both open and closed GitHub issues against design specifications. It uncovers missing requirements, half-finished deliverables, and scope drift by comparing spec text against the issue tree and applying validation guardrails to minimize false positives.

What's the best way to automate spec audits after an implementation batch?

Automated spec audits run after implementation batches using date filters and remediation flags. Running with a start date parameter audits all specs from that point onward, emits gap findings, and generates a regression issue queue routed back through the split workflow.

Do I need linked GitHub issues for spec gap detection to work?

Yes, deterministic spec discovery and issue linkage are required. The audit applies taxonomy-based gap classification with validation guardrails by comparing design spec text against linked GitHub issue trees, so issues must be connected to the specifications beforehand.