ears-writer

Converts natural-language requirements into standardized EAS sentences.

Updated Apr 21, 2026
One-click install
npx skills add https://github.com/LeeHusung/harness --skill ears-writer
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: ears-writer
Source: https://github.com/LeeHusung/harness/tree/main/.claude/skills/ears-writer
Command: npx skills add https://github.com/LeeHusung/harness --skill ears-writer

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Natural language requirements are often ambiguous or inconsistent. EARS Writer transforms them into standardized EARS sentences, ensuring traceability and clarity for development teams.

Core Features & Use Cases

  • Converts natural-language requirements into the five EARS patterns (Ubiquitous, Event-driven, State-driven, Unwanted, Optional).
  • Improves requirement clarity, testability, and automation readiness across product and engineering workflows.
  • Use Case: Given a user story like "The system shall log out inactive users after 15 minutes," EARS Writer outputs the corresponding EARS sentence(s) for precise verification.

Quick Start

Provide a natural language requirement and EARS Writer will output a set of standardized EARS sentences.

Frequently Asked Questions about ears-writer

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

FAQPage Schema
What is the EARS pattern for requirements writing?

The EARS pattern is a standardized syntax for writing natural language requirements, dividing them into five categories: Ubiquitous, Event-driven, State-driven, Unwanted, and Optional. It enforces explicit conditions and clear triggers to improve specification clarity.

How do I convert natural language requirements into EARS sentences?

To convert natural language requirements into EARS sentences, input the raw specification and the tool reformats it into standardized syntax. It applies the five EARS patterns to ensure testable conditions with explicit triggers and responses.

Why should I use EARS for product specification and requirements gathering?

You should use EARS for product specification because it eliminates natural language ambiguity. It transforms requirements into standardized EARS sentences, ensuring traceability, testability, and consistency across engineering and product teams.

Does EARS work for engineering requirements with specific triggers and responses?

Yes, EARS works for engineering requirements by enforcing explicit, testable conditions. It reformats natural language inputs into standardized sentences with clear triggers and responses, ensuring automation readiness and precise verification.

Can I use EARS writing for user stories and editorial consistency tasks?

Yes, you can use EARS writing for user stories and editorial consistency tasks. It analyzes natural language like logging out inactive users and outputs standardized EARS sentences to ensure precise verification and consistent formatting.

What are the limitations of using EARS patterns for requirements?

A limitation of using EARS patterns is that it strictly enforces five sentence structures, which may constrain complex logic. It reformats natural language into standardized sentences, requiring explicit conditions that might oversimplify nuanced engineering requirements.