reviewing-feature-spec

Review finished feature specifications against a 10-condition implementability and testability bar.

1|1|Updated May 24, 2026
One-click install
npx skills add https://github.com/bm629/agent-skills --skill reviewing-feature-spec-bm629
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: reviewing-feature-spec
Source: https://github.com/bm629/agent-skills/tree/main/skills/reviewing-feature-spec
Command: npx skills add https://github.com/bm629/agent-skills --skill reviewing-feature-spec-bm629

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve? Engineering teams need an independent acceptance gate that decides whether a finished feature specification is complete enough to plan, build, and test from, without the author grading their own work. ## Core Features & Use Cases - 10-Condition Acceptance Gate: Judges a spec against a single-sourced implementability and testability checklist covering traceability, unambiguous behavior, complete I/O and states, edge-case handling, testable acceptance criteria, consistency, feasibility, open questions, NFRs, and delta-scoped amends. - Machine-Parseable Verdict: Emits exactly one line, VERDICT: approve or VERDICT: revise, followed by actionable findings naming the failed condition, location, and concrete fix. - Proportional Review: Collapses conditions a thin feature legitimately does not need (no state table, no NFRs, no changelog on a first draft) to avoid false-revise verdicts. - Use Case: After a producer authors a feature spec for a new checkout flow, run this skill before sprint planning to confirm every behavior is unambiguous, every edge case names its handling, and every acceptance criterion is independently testable. ## Quick Start Review the finished feature spec at docs/specs/checkout-v2.md and emit an approve or revise verdict with actionable findings.

Frequently Asked Questions about reviewing-feature-spec

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

FAQPage Schema
How do I review a feature specification before engineering starts?

Hand the finished spec to this skill, which reads it end to end and judges it against a 10-condition implementability and testability checklist. It emits a single VERDICT: approve or VERDICT: revise line followed by actionable findings naming each failed condition, its location, and the fix.

What makes a feature spec acceptance criterion testable?

A testable criterion gives a tester a pass/fail check executable without asking the author, typically Given/When/Then or a rule-based checklist. For probabilistic or ML features, a metric threshold on a named dataset plus a fallback behavior is the correct testable form; vague phrases like the model is accurate are gaps.

What is the difference between reviewing a feature spec and reviewing a PRD?

A PRD review judges product plannability at the what/why level, while a feature spec review judges per-feature implementability one layer down. This skill only handles feature specs; use a PRD-review skill for the upstream product document and a design-review skill for engineering design documents.

Can this skill review an amended or changed feature spec?

Yes, it supports delta-scoped amend reviews via condition 10. It reviews only the changed blocks plus their ripple, checking traceability, version bump, changelog entry, and marked superseded content, without re-reviewing the unchanged spec.

Why does a spec review approve a short or thin specification?

The bar is proportional: a thin feature legitimately omits state tables, decision tables, NFRs, and changelogs it does not need. A small spec satisfying every applicable condition passes, because the review judges completeness of decisions, not word count or template sections.

When should I not use this feature spec review skill?

Do not use it for authoring or repairing a spec, reviewing the upstream PRD, reviewing engineering design documents like ADRs or RFCs, or checking template section conformance. It is strictly an acceptance gate that judges and returns findings without rewriting.