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 instruction-only skill body: lean imperative procedures with explicit stop conditions, a full validation phase, error-feedback loops, and cleanly disclosed one-level-deep bundle files that all exist. The only minor gap is that the core session-wrapper code lives entirely in the template asset rather than being at least sketched inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is purely imperative directives with zero concept explanation and no padding — every line instructs ('Gate session creation behind LanguageDetector.availability()...', 'Use AbortController for cancelable create(), detect()... calls'), assuming Claude's competence, which matches the 'lean and efficient; every token earns its place' anchor. | 5 / 5 |
Actionability | Concrete guidance throughout: an executable command ('node scripts/find-language-detector-targets.mjs .'), exact API surfaces (availability(), create(), detect(), measureInputUsage(), destroy()), and named exceptions (NotAllowedError, InvalidStateError, QuotaExceededError) with responses. However, the actual wrapper implementation is delegated to assets/language-detector-session.template.ts rather than shown, leaving minor gaps versus fully copy-paste-ready code. | 4 / 5 |
Workflow Clarity | Five clearly sequenced steps culminate in a dedicated validation phase (Step 5: re-run the inventory script, test create()+detect() flows, confirm abort/destroy semantics, run build/typecheck/tests), and the Error Handling section provides feedback loops for each named failure — matching the 'explicit validation steps; feedback loops for error recovery' anchor. | 5 / 5 |
Progressive Disclosure | The body is a concise procedural overview with conditional, well-signaled one-level-deep references ('Read references/examples.md when the feature needs a session wrapper, download-progress UI...'), and all referenced bundle files (4 references, 1 script, 1 asset template) exist with no nested reference chains, matching the top anchor. | 5 / 5 |
Total | 19 / 20 Passed |