requirements-validator

Validate user stories and acceptance criteria using INVEST and SMART scoring; generates BDD-ready reports with rewrite suggestions.

Updated Apr 29, 2026
One-click install
npx skills add https://github.com/djd1m/2026-PU-APR-LESSON-05-instanly-01 --skill requirements-validator-djd1m
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: requirements-validator
Source: https://github.com/djd1m/2026-PU-APR-LESSON-05-instanly-01/tree/main/.claude/skills/requirements-validator
Command: npx skills add https://github.com/djd1m/2026-PU-APR-LESSON-05-instanly-01 --skill requirements-validator-djd1m

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill validates requirements and acceptance criteria using INVEST and SMART criteria, then generates clear, testable BDD scenarios and actionable fixes to accelerate development.

Core Features & Use Cases

  • INVEST + SMART scoring for user stories and acceptance criteria to surface ambiguity and risk.
  • Automatic generation of Gherkin/BDD scenarios with happy paths, edge cases, and security considerations.
  • Validation reports with concrete rewrite suggestions and acceptance criteria improvements.
  • Works across product backlog items, user stories, and requirements documents to defend quality gates before development.

Quick Start

Provide your user stories and acceptance criteria to generate a BDD-ready validation report.

Frequently Asked Questions about requirements-validator

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

FAQPage Schema
How do I validate user stories for testability and clarity before development?

Generate BDD scenarios by validating acceptance criteria using INVEST and SMART frameworks. The process outputs Gherkin scenarios covering happy paths, edge cases, and security considerations to accelerate QA-ready development.

What is the best way to check if acceptance criteria are ready for QA?

Checking QA readiness involves scoring acceptance criteria against INVEST and SMART principles. This yields structured validation reports with concrete rewrite suggestions and risk remediation to defend quality gates.

Can I use INVEST and SMART scoring on my product backlog items?

Yes, INVEST and SMART scoring works across product backlog items, user stories, and requirements documents. It evaluates testability and clarity to provide actionable guidance for development readiness across software projects.

How do I generate Gherkin scenarios from ambiguous requirements?

Generate Gherkin scenarios by processing ambiguous requirements through INVEST and SMART validation. The system outputs BDD scenarios with happy paths and edge cases, alongside remediation suggestions to clarify the original requirements.

Does validating requirements with INVEST provide actionable fixes for backlog items?

Yes, validating requirements with INVEST provides actionable fixes by generating validation reports containing concrete rewrite suggestions and acceptance criteria improvements for backlog items.