ms-foundation-ears

Validate requirements against EARS patterns and detect forbidden phrases.

Updated Oct 16, 2025
One-click install
npx skills add https://github.com/beomeodev/specter --skill ms-foundation-ears
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ms-foundation-ears
Source: https://github.com/beomeodev/specter/tree/main/.claude/skills/ms-foundation-ears
Command: npx skills add https://github.com/beomeodev/specter --skill ms-foundation-ears

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Requirements often suffer from ambiguity, vagueness, or improper language that makes them hard to implement, test, and verify. This skill ensures that requirements conform to EARS patterns and flags forbidden phrases, improving clarity and traceability. It also guides you to rewrite non-compliant statements into measurable, testable specs.

Core Features & Use Cases

  • Enforces the five EARS patterns (Ubiquitous, Event-driven, State-driven, Optional, and Constraints) to structure requirements consistently.
  • Detects common forbidden phrases and provides concrete rewrite suggestions to remove ambiguity.
  • Verifies measurability and testability by requiring clear pass/fail criteria and test cases, plus guidance for traceability.
  • Ideal for writing new specifications, clarifying existing requirements, and performing SPEC reviews to reduce ambiguity.

Quick Start

Write your requirement in natural language and run the validator to receive a compliance report.

Frequently Asked Questions about ms-foundation-ears

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

FAQPage Schema
How do I validate requirements against EARS patterns to reduce ambiguity?

To validate requirements against EARS patterns, run the validator on your natural language specifications to receive a structured compliance report detailing detected patterns, forbidden phrase violations, and suggested rewrites.

What are forbidden phrases in requirements specification and how do I fix them?

Forbidden phrases in requirements specification are vague or ambiguous terms that hinder testability; the validator detects them and provides concrete rewrite suggestions to ensure your requirements are measurable and clear.

How do I rewrite non-compliant requirements to ensure measurability and testability?

You can rewrite non-compliant requirements for measurability and testability by applying the validator's suggested rewrites, which enforce clear pass/fail criteria and align your statements with the five EARS patterns.

When do I need to use EARS patterns for writing software specifications?

You need EARS patterns for writing software specifications when structuring requirements consistently across Ubiquitous, Event-driven, State-driven, Optional, and Constraint categories to improve traceability and reduce implementation errors.

Can I use this validator for reviewing existing requirements during a SPEC review?

Yes, you can use the validator for reviewing existing requirements during a SPEC review; it assesses each statement for measurability, detects forbidden phrases, and outputs metadata detailing compliance and rewrite suggestions.

What is the best way to enforce clear pass/fail criteria in software requirements?

The best way to enforce clear pass/fail criteria is to validate requirements against EARS patterns, which flags ambiguous language and guides you to rewrite non-compliant statements into structured, testable specifications.