Content
100%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 an exemplary process skill: lean and dense with zero over-explanation, concrete identifiers and commands at every step, an explicitly sequenced workflow with validation checkpoints and stop conditions, and disciplined externalization of contracts, catalogues, and specialist guidance to one-level-deep references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body teaches nothing Claude already knows and contains no filler; every line is a rule, identifier, or decision criterion ('Unknown, malformed, unavailable, and stale IDs fail closed', 'Scopes are opaque run identities. They are not selectors, persisted state, release-note input, or authorization tokens.'). The 'Stop and redesign when' recap functions as a safety checklist rather than padding. | 5 / 5 |
Actionability | For an instruction-only skill the guidance is fully concrete: exact API names (createOnboardingClickStep, createOnboardingContextStep, markOnboardingTarget, captureTargetScope: true), exact commands (npm run valid-layers-check, npm run typecheck-client, npm run build-fast, Developer: Copy Feature Example Link), a copy-paste markup example (try(myFeature.guide,Try My Feature)), and decision tables covering the common cases. | 5 / 5 |
Workflow Clarity | Twelve numbered sections form a coherent sequence (classify -> ownership -> presentation -> trust boundary -> scoping -> prerequisites -> Chat/AI -> Agents window -> specialist guidance -> markup -> tests -> validation) with explicit validation checkpoints: a per-capability required-coverage table (section 11), an ordered run list (section 12), and checklists ('Stop and redesign when', completion report fields). | 5 / 5 |
Progressive Disclosure | The skill delegates one level deep and refuses to inline reference material: the authoritative contract goes to the onboarding README ('Read it before implementation... must not duplicate a catalogue of current tryouts'), canonical implementations and test files are linked directly, and specialist concerns are routed to six named skills. The inline content is the workflow decision logic itself, appropriately placed in SKILL.md, with twelve titled sections making navigation easy. (Referenced repo paths do not resolve in this review sandbox, but that reflects extraction from the home monorepo, not a skill defect.) | 5 / 5 |
Total | 20 / 20 Passed |