Content
75%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.
A well-crafted instruction-only skill body: concrete rubrics, weights, an ordered evidence-collection procedure, explicit bias controls, and a copy-paste output template. It consistently sits just below the top anchors due to repetition between sections, an unspecified tension-plot artifact, and absent failure/recovery guidance.
Suggestions
Consolidate the "score both poles separately / never average" and "no single composite score" guidance — currently stated in four or more places (positioning brief, Why these dimensions, dimension 9, Tension axes, Bias controls, Anti-Patterns) — into one authoritative statement with cross-references.
Specify how the tension 2x2 plot is actually produced (artifact format, axes, quadrant labeling) and add one worked example of a filled profile card row so the output is unambiguous.
Add an explicit recovery step for missing evidence (e.g., what to record when no source supports a dimension) and merge the overlapping Bias controls and Anti-Patterns sections, or move one into a reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and prescriptive with no explanation of concepts Claude already knows ("No score without evidence", "Distinguish asserted from proven"), but "score BOTH poles, report separately" and the no-single-composite rule are each repeated in four or more places, and "Bias controls" substantially overlaps "Anti-Patterns". That is minor trimmable repetition (anchor 4), not the unnecessary explanation that would warrant 3. | 4 / 5 |
Actionability | Guidance is mostly executable: exact dimension weights, anchored 1-5 rubric, an ordered six-source collection procedure (site, case studies, directories, LinkedIn, portfolio, content channels), and a copy-paste profile card template with a table. It falls short of 5 because "Plot competitors on the tension 2x2" never specifies the artifact format, and there is no worked example of a scored dimension or filled card row. | 4 / 5 |
Workflow Clarity | The sequence is clear and well-ordered — establish the positioning brief first, collect in cheapest-signal-first order, then "Calibrate across the set, not in isolation... re-read scores side-by-side... Adjust outliers" is an explicit pre-finalize checkpoint. It is not 5 because there is no recovery guidance for common failure states (e.g., what to do when no evidence can be found for a dimension). | 4 / 5 |
Progressive Disclosure | No bundle files exist, and the single ~180-line body is well organized with clear section headers (When to Activate, dimensions, rubric, data collection, bias controls, output format, anti-patterns, related skills). It is not 5 because at this length some self-contained blocks (bias controls/anti-patterns, the card template) could live in a one-level reference file, and the skill exceeds the under-50-line simple-skill case where organization alone earns a 5. | 4 / 5 |
Total | 16 / 20 Passed |