Content
88%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 dense, highly actionable style guide: literal banned-word lists, five before/after transformations, a self-check heuristic, and context-specific calibration. The soft spots are conciseness and progressive disclosure — the mic-drop rule is explained twice, and at roughly 95 lines the banned lists and examples could be externalized to keep SKILL.md leaner.
Suggestions
Fold the Example 5 explanation into the mic-drop bullet in "Rhythm and structure" (or vice versa) — the rule is currently explained in full twice, and one occurrence can carry the point.
Move the banned word/phrase lists and/or the five worked examples into a one-level reference file (e.g., references/banned.md, references/examples.md) referenced from the body, keeping SKILL.md to the core voice rules and letting the lists load on demand.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and Max-specific throughout — it states preferences rather than explaining concepts Claude already knows, and the banned word/phrase lists are compact list-form with no padding. Minor trimmable redundancy keeps it below a 5: the mic-drop rule is fully explained in "Rhythm and structure" and then re-demonstrated with its own explanation in Example 5, the dash guidance recurs in Example 4's parenthetical, and there are flavor asides ("(Yes, even though he's British about most things...)"). | 4 / 5 |
Actionability | For an instruction-only skill this is maximally actionable: literal banned word and phrase lists that can be cut on sight ("delve, leverage (as a verb), utilize..."), five concrete before/after transformation pairs covering the common failure cases, an executable self-check ("read your first sentence. If deleting it loses nothing, delete it"), and per-context calibration with concrete examples ("Fix race condition in cache eviction"). | 5 / 5 |
Workflow Clarity | A simple single-task skill (apply these style rules whenever writing prose for Max) whose single action is unambiguous: a governing principle up front ("When in doubt, cut words and warm up the tone"), hard rules, then a "Calibration by context" section that sequences how the formality dial moves by output type. No destructive or batch operations exist, so the validation cap does not apply. | 5 / 5 |
Progressive Disclosure | The single-file body is well organized with a logical section flow (voice → hard rules → banned → padding → marketing tone → rhythm → examples → calibration) and no buried content. However, the rubric's simple-skill carve-out (a 5 from well-organized sections alone) covers only skills under 50 lines with no need for external references; this body is roughly 95 lines, and the banned word/phrase lists and five worked examples are inlined where a one-level reference file could hold them to keep the core file lean. | 4 / 5 |
Total | 18 / 20 Passed |