feature-review

Review feature specifications for completeness and generate missing Gherkin scenarios.

Updated Feb 8, 2026
One-click install
npx skills add https://github.com/mlbright/notes --skill feature-review-mlbright
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: feature-review
Source: https://github.com/mlbright/notes/tree/main/.github/skills/feature-review
Command: npx skills add https://github.com/mlbright/notes --skill feature-review-mlbright

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes scripts (resource) and references (resource) components.

What problem does it solve?

This Skill addresses the common issue of incomplete, unclear, or low-quality feature specifications, which can lead to development delays, scope creep, and misaligned product outcomes.

Core Features & Use Cases

  • Comprehensive Validation: Assesses specifications against a detailed checklist of essential and desirable criteria.
  • Gap Identification: Pinpoints missing information, ambiguities, and potential issues.
  • Automated Content Generation: Creates missing Gherkin scenarios and suggests validation rules.
  • Actionable Feedback: Provides structured reports with severity-ranked findings and clear recommendations.
  • Use Case: A product manager submits a new feature specification for a user authentication system. The Skill reviews it, identifies missing edge cases for password resets, suggests specific error messages, and generates Gherkin scenarios for the happy path and common failure points.

Quick Start

Review the feature specification located at 'features/user-onboarding.md'.

Frequently Asked Questions about feature-review

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

FAQPage Schema
How do I review a feature specification for completeness and clarity?

To review a feature specification, assess it against a defined checklist of essential criteria to identify missing information and ambiguities. This process generates missing Gherkin scenarios and provides actionable improvement suggestions ranked by severity.

What is Gherkin generation and how does it validate feature requirements?

Gherkin generation is an automated requirements validation technique that creates structured behavior scenarios from feature specifications. It ensures testability by pinpointing missing edge cases and generating validation rules for both happy paths and common failure points.

How do I identify gaps and edge cases in a product feature specification?

Identifying gaps in a product feature specification requires assessing the document against a detailed checklist of essential and desirable criteria. This quality assurance process pinpoints missing information, generates missing Gherkin scenarios for edge cases, and provides clear recommendations categorized by severity.

Can I use automated quality assurance to score feature specs for scope creep?

Automated quality assurance can score feature specifications by evaluating them against a defined set of criteria to prevent scope creep. The review categorizes issues by severity, identifies ambiguities, and provides actionable feedback to align product outcomes and minimize development delays.

What's the best way to generate Gherkin scenarios from an existing feature spec?

The best way to generate Gherkin scenarios from an existing feature spec is to run a specification review that identifies missing information and ambiguities. The automated content generation process creates specific validation rules and Gherkin scenarios for both the happy path and common failure points.