prompt-optimizer

prompt-optimizer transforms vague, loosely worded requirements into precise, testable specifications using EARS (Easy Approach to Requirements Syntax), a structured requirements methodology originally created by Rolls-Royce. It solves the common problem of ambiguous feature requests — "build a dashboard," "make it user-friendly" — that lack triggers, conditions, and measurable outcomes and therefore produce unpredictable AI-generated code or documents.

The skill applies a four-layer enhancement process across a six-step workflow: it analyzes the original requirement for weaknesses, converts language into EARS patterns (ubiquitous, event-driven, state-driven, conditional, and unwanted-behavior), grounds requirements in relevant domain theories (GTD, BJ Fogg, Gestalt, Hick's Law, Zero Trust, and others), extracts concrete realistic examples, and generates a structured prompt using a Role/Skills/Workflows/Examples/Formats framework. Supporting reference files document the full EARS syntax, advanced multi-stakeholder and non-functional patterns, worked examples, and a catalog of domain theories.

It is aimed at product managers, engineers, prompt authors, and anyone who needs to turn natural-language intent into atomic, unambiguous, verifiable requirements. Typical uses include refining feature specs before handing them to an AI coding tool, tightening acceptance criteria, and adding measurable constraints such as time bounds or password length to otherwise vague asks. It is a pure documentation and methodology helper with no executable code beyond reference material.