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.
An exemplary instruction-only skill body: lean, app-specific, and immediately actionable, with a complete code example, precise parameter decision rules, and clean section structure. No bundle files exist or are needed.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~50-line body explains nothing Claude already knows; every sentence is app-specific policy (parameter semantics, submit/background behavior, boundary rules), matching the 'lean and efficient; every token earns its place' anchor. | 5 / 5 |
Actionability | The body provides a copy-paste-ready TypeScript snippet with its full import path, plus exact decision rules for each call variant ('submit: true' vs 'submit: false' prefill, 'background: true' with 'openSidebar: false') and explicit prohibitions (no provider SDKs, no hidden second agent), fully covering the common cases. | 5 / 5 |
Workflow Clarity | This is a single-action routing skill and that action is unambiguous with clear variant-selection guidance; per the simple-skill guideline, workflow clarity can score 5, and no destructive or batch operations exist that would require validation checkpoints. | 5 / 5 |
Progressive Disclosure | The body is under 50 lines with no need for external references, organized into clear sections (Rule, Start a visible agent turn, Keep the boundary clear, Related skills), and its cross-skill pointers are one level deep and clearly signaled, satisfying the simple-skill exception for a top score. | 5 / 5 |
Total | 20 / 20 Passed |