Content
77%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured, highly actionable methodology with explicit rubrics, a defined collection procedure, a copy-paste output template, and clear validation via calibration. The main gaps are token-efficiency (heavy repetition of the no-averaging rule) and the absence of progressive disclosure — everything lives in one ~150-line file.
Suggestions
Consolidate the 'score both tension poles, never average them' guidance into one authoritative statement and reference it, rather than restating it in five sections.
Move the nine-dimension definitions and/or the profile-card template into a referenced file (e.g. DIMENSIONS.md or PROFILE-CARD.md) to enable progressive disclosure and shorten the main SKILL.md overview.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and free of generic filler Claude already knows, but the 'never average the tension axes' rule is restated across at least five sections (Client positioning brief, Why these dimensions, dimension 9, Bias controls, Anti-Patterns) and the tension concept is explained twice; it is mostly efficient but could be tightened, fitting level 2 rather than the every-token-earns-its-place level 3. | 2 / 3 |
Actionability | Provides explicit 1-5 rubric anchors, a numbered data-collection order with per-source extraction guidance ('Screenshot the homepage + one case study', 'Distinguish asserted from proven'), and a copy-paste-ready competitor profile card template; concrete and specific, matching the level-3 anchor for an instruction-only skill. | 3 / 3 |
Workflow Clarity | Clear sequence (positioning brief -> score nine dimensions -> profile cards -> hand to competitive-report-structure) with precondition gating in 'When to Activate' and an explicit validation checkpoint in Bias controls ('re-read scores side-by-side ... a 4 must mean the same thing ... Adjust outliers'), meeting the level-3 clear-sequence-with-validation bar. | 3 / 3 |
Progressive Disclosure | Well-organized into clearly headed sections, but the skill is entirely monolithic (~150 lines with no external detail references); at this length it exceeds the under-50-line simple-skill threshold where organization alone earns a 3, and the dimension definitions and output template are inline content the level-3 anchor expects to be split into signaled one-level-deep references. | 2 / 3 |
Total | 10 / 12 Passed |