Transform vague prompts into precise, well-structured specifications using EARS (Easy Approach to Requirements Syntax) methodology. This skill should be used when users provide loose requirements, ambiguous feature descriptions, or need to enhance prompts for AI-generated code, products, or documents. Triggers include requests to "optimize my prompt", "improve this requirement", "make this more specific", or when raw requirements lack detail and structure.
88
83%
Does it follow best practices?
Impact
96%
1.62xAverage score across 3 eval scenarios
Passed
No known issues
Quality
Discovery
82%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a solid description with strong trigger term coverage and good completeness, explicitly stating both what the skill does and when to use it. The main weaknesses are moderate specificity (could list more concrete actions) and some potential overlap with general writing/editing or prompt engineering skills.
Suggestions
Add more specific concrete actions like 'generate EARS-formatted requirements', 'convert user stories to structured specifications', or 'validate requirement completeness'
Strengthen distinctiveness by emphasizing unique EARS outputs or formats that differentiate this from general prompt improvement skills
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (EARS methodology, requirements) and the general action (transform vague prompts into specifications), but doesn't list multiple concrete actions like 'parse requirements', 'generate EARS templates', or 'validate syntax'. | 2 / 3 |
Completeness | Clearly answers both what (transform vague prompts into precise specifications using EARS) and when (explicit triggers listed including 'optimize my prompt', 'improve this requirement', and contextual conditions like 'raw requirements lack detail'). | 3 / 3 |
Trigger Term Quality | Includes excellent natural trigger phrases users would say: 'optimize my prompt', 'improve this requirement', 'make this more specific', plus contextual triggers like 'loose requirements' and 'ambiguous feature descriptions'. | 3 / 3 |
Distinctiveness Conflict Risk | The EARS methodology provides some distinctiveness, but 'improve this requirement' and 'make this more specific' could overlap with general writing improvement or editing skills. The prompt optimization angle could conflict with other prompt engineering skills. | 2 / 3 |
Total | 10 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured skill with strong actionability and excellent progressive disclosure. The six-step workflow is clear and the EARS methodology is well-explained with concrete examples. Minor verbosity in the overview and some sections could be tightened, but overall the skill provides comprehensive, executable guidance for prompt optimization.
Suggestions
Trim the overview section - remove the methodology attribution paragraph and condense the four-layer process description into a more compact format
Remove redundant quality criteria that repeat concepts already demonstrated in the examples and templates
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill is reasonably efficient but includes some unnecessary explanation (e.g., the methodology attribution paragraph, some redundant framing). The overview could be tighter, and some sections like 'Quality criteria' repeat concepts already implied by the framework. | 2 / 3 |
Actionability | Provides concrete, executable guidance with specific EARS patterns, transformation checklists, structured output templates, and real before/after examples. The six-step workflow is clear with specific actions at each step. | 3 / 3 |
Workflow Clarity | The six-step workflow is clearly sequenced with explicit phases, checklists, and structured output format. Each step has clear inputs/outputs and the transformation checklist provides validation checkpoints. | 3 / 3 |
Progressive Disclosure | Excellent structure with a clear overview, well-organized main content, and clearly signaled one-level-deep references to four specific reference files. The 'When to load references' section provides clear navigation guidance. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
4f0eae8
Table of Contents
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.