Content
86%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-engineered routing skill: an overview body with task-to-reference tables, one-level-deep references that all exist, and concrete operational rules. Its only costs are mild repetition of the 'read the bundled files' instruction and validation loops being delegated to bundled references rather than stated inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean, assumes competence, and explains nothing Claude already knows — it routes via task tables instead of padding. However, the instruction to load bundled references is repeated in several forms ('Before recommending an extension or writing code, load the applicable bundled reference files', 'After selecting the capability, load the applicable files', 'open those files with a file-reading tool before starting the corresponding work'), and 'A link or filename in this skill isn't a substitute for reading its contents' restates it again. This is minor over-explanation that could be trimmed, matching 'efficient; minor instances of over-explanation'. | 4 / 5 |
Actionability | For an instruction/routing skill, the guidance is fully actionable: task tables map each request type to exact bundled files and canonical URLs (e.g., 'Author, test, or debug a script extension' → '<references/script-extensions.md>, then the selected extension point's implementation guide'), with concrete rules like 'Prefer `stripe docs` when available' and explicit resolution rules for reference paths. Per the scoring notes, absence of code is not penalized when the guidance is this specific. | 5 / 5 |
Workflow Clarity | The sequence is clear: select capability → read product docs → load bundled references → follow their pointers to canonical docs → create/modify files → report changes. Checkpoints are present ('state what is unknown or unsupported before proceeding'; version-disagreement rule: 'If an example in a reference disagrees, check the version and follow the applicable canonical documentation'; 'Report the changes, validation results, and remaining steps'), but there is no explicit validate-after-build feedback loop in the body itself — validation/testing is delegated to references/workflow.md. This matches 'clear sequence with most checkpoints present; minor validation gaps'. | 4 / 5 |
Progressive Disclosure | The body is a pure routing overview: every one of the 12 referenced files (discovery, extension-types, ui-extensions, script-extensions, backend, authentication, webhooks, canonical-docs, workflow, onboarding-ux, publishing, feedback) exists in ./references/, each is one level deep and clearly signaled via task tables, and no detailed content is inlined. Navigation is easy — a task maps to exactly the files needed, with rules for combining rows and following cross-references. | 5 / 5 |
Total | 18 / 20 Passed |