CtrlK
BlogDocsLog inGet started
Tessl Logo

prompt-optimizer

Transforms vague prompts or feature requests into precise, testable specifications using EARS (Easy Approach to Requirements Syntax) grounded in relevant domain theories (GTD, BJ Fogg, Gestalt). Use when requirements lack triggers or measurable outcomes, or the user asks to "optimize my prompt" / "improve this requirement" / "make this more specific".

67

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

78%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured instructional skill: a clear six-step workflow with checklists, concrete templates and examples, and exemplary progressive disclosure through four genuinely useful, correctly signaled reference files. Remaining gains are small — trimming the marketing-flavored phrasing and adding an explicit review/rework loop after prompt generation.

DimensionReasoningScore

Conciseness

The body is dense and actionable with little concept re-teaching, but has minor trimmable padding ('a Rolls-Royce methodology' flourish, the methodology-inspired attribution, and slight duplication between the inline five-pattern list and references/ears_syntax.md), fitting the 'efficient; minor instances of over-explanation' anchor rather than the every-token-earns-its-place 5 anchor.

4 / 5

Actionability

Concrete, executable guidance throughout: a real before/after EARS example, a transformation checklist, specific domain mappings, and copy-paste output templates; however, full worked examples are deferred to references/examples.md rather than covering the common cases inline, so it matches the 'mostly executable with minor gaps' 4 anchor instead of the 5 anchor.

4 / 5

Workflow Clarity

The six steps are clearly sequenced with checkpoints (the Step 2 transformation checklist and Step 5 quality criteria), matching the 'clear sequence with most checkpoints' 4 anchor; it lacks an explicit verify/rework feedback loop after generating the enhanced prompt, keeping it below the 5 anchor, and it is well above the implicit-checkpoint 3 anchor.

4 / 5

Progressive Disclosure

The body is a lean overview that cites each of the four real one-level-deep reference files at the exact step where needed, lists them in Resources with descriptions, and adds explicit 'When to load references' conditions — all four files exist and match their claims — matching the 5 anchor for well-signaled, easy navigation.

5 / 5

Total

17

/

20

Passed

Description

83%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: it states a clear third-person capability with a named methodology, and includes an explicit 'Use when' clause with realistic quoted trigger phrases. The only weaknesses are modest coverage of the action space and a few missing natural synonyms, plus minor overlap risk with general prompt-improvement requests.

DimensionReasoningScore

Specificity

The description names a concrete action ('Transforms vague prompts or feature requests into precise, testable specifications') with the specific method (EARS) and grounding theories, but covers a single transformation action rather than a comprehensive list of several actions, so it matches the 'several specific actions; minor gaps' anchor rather than the 5 anchor and is clearly above the 1-2-action anchor.

4 / 5

Completeness

It explicitly answers both what ('Transforms vague prompts... into precise, testable specifications using EARS') and when ('Use when requirements lack triggers or measurable outcomes, or the user asks to...') with concrete quoted trigger phrases, matching the 5 anchor exactly; it is clearly above the 4 anchor where the 'when' could be more specific.

5 / 5

Trigger Term Quality

Natural user phrases are present ('optimize my prompt', 'improve this requirement', 'make this more specific') plus the condition 'requirements lack triggers or measurable outcomes', giving good keyword coverage; a few natural synonyms (e.g., 'refine', 'clarify') are missing, which fits the 4 anchor rather than comprehensive coverage at 5.

4 / 5

Distinctiveness Conflict Risk

The EARS/requirements-syntax niche with quoted trigger phrases is mostly distinct, but 'optimize my prompt' could overlap with generic prompt-writing or editing skills, matching the 'mostly distinct; minor overlap risk' anchor rather than the minimal-conflict 5 anchor.

4 / 5

Total

17

/

20

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 — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
daymade/claude-code-skills
Reviewed

Table of Contents

Is this your skill?

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.