Content
25%Weight 40%Scale 1-5Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is a short shell of padded framing (persona, circular use/don't-use sections, unsourced statistics) whose actual instructional content is a handful of vague directives. Its one concrete element — the playbook reference — points to a file that does not exist, leaving the skill with no usable guidance.
Suggestions
Replace the vague Instructions bullets with a concrete, sequenced optimization workflow, e.g. capture the current prompt and target model, restructure with explicit structure/examples, run both versions on the same inputs, and compare outputs before adopting.
Either create resources/implementation-playbook.md with the promised patterns and examples, or inline the essential patterns into SKILL.md and drop the dangling reference (also note the conventional bundle directory is references/).
Delete the persona sentence, the circular 'Do not use this skill when' section, and the unverifiable 40%/30%/50-80% statistics; use the reclaimed tokens for one worked before/after prompt example.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Several sections are padded rather than informative: the persona line "You are an expert prompt engineer specializing in...", the circular "Do not use this skill when - The task is unrelated to prompt optimization", and unsourced marketing statistics ("improve accuracy by 40%, reduce hallucinations by 30%, and cut costs by 50-80%"). This matches 'noticeably verbose; several unnecessary explanations or padded sections' — the token waste is proportional even though the body is short. | 2 / 5 |
Actionability | The Instructions are abstract directives ("Clarify goals, constraints, and required inputs", "Apply relevant best practices and validate outcomes") with no concrete technique, example, or command — they describe rather than instruct. It avoids a 1 only because one concrete pointer exists ("open resources/implementation-playbook.md"), but that file does not exist in the bundle, so the only specific guidance is a dead end. | 2 / 5 |
Workflow Clarity | The bullets form only a rough sequence (clarify → apply → validate → provide steps) with many gaps, poorly defined steps, and no validation checkpoints of any kind, matching the 'rough sequence present but many gaps; validation absent' anchor. The 'validate outcomes' bullet names validation without saying how or when to check anything. | 2 / 5 |
Progressive Disclosure | Although the body has sections and a clearly signaled, one-level-deep reference, that reference is dangling: no resources/ directory or implementation-playbook.md exists in the bundle, and all detailed content is delegated to it ("If detailed examples are required, open resources/implementation-playbook.md"). The disclosure chain is broken, which is worse than an unhelpfully-signaled but real reference, and the Resources section merely duplicates the inline pointer. | 2 / 5 |
Total | 8 / 20 Passed |