Content
92%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.
An exemplary lean, instruction-only skill: it assumes Claude's competence, gives a fully concrete job spec for the background agent including source-quality criteria, output format, and placement convention, and handles the no-convention fallback explicitly. The only minor gap is the absence of a sample findings-file layout or citation format, which would make the output expectations copy-paste concrete.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every phrase changes behavior — "Start it with a fresh context window", "a single Markdown file", "citing each claim's source", "match the existing convention" — with zero padding and no explanation of concepts Claude already knows. This matches the lean, every-token-earns-its-place anchor. | 5 / 5 |
Actionability | For an instruction-only skill the guidance is concrete and directive: spin up a background agent, investigate primary sources enumerated as "official docs, source code, specs, first-party APIs", write one Markdown file with per-claim citations, and place it per repo convention with an explicit fallback. It falls just short of anchor 5 because no example of the findings-file structure or citation format covers the common case. | 4 / 5 |
Workflow Clarity | The sequence is clear and unambiguous — spin up the agent, then a numbered job spec — and includes an explicit decision branch ("if there is none, put it somewhere sensible and say where"). This is a single-purpose, non-destructive task, so the simple-skill exception applies and no validation checkpoint is required. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines, needs no external references, and no bundle files exist — the body is well organized into a setup line, a job header, and a numbered list. Per the simple-skill guideline, this earns the top score without external file references. | 5 / 5 |
Total | 19 / 20 Passed |