Content
88%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: a cost-ordered reading ladder with exact tool syntax, a question-to-surface routing table, edge-case handling, and honest boundary sections. The only notable gap is that `executions` — one of the four recommended tools — is pointed at repeatedly without its call syntax ever being shown.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence throughout — it explains only instance-specific behavior (the <instance-context> block, the 20-entry expand cap, retention windows) and nothing Claude would already know. Every section teaches something non-obvious about this instance's surfaces. | 5 / 5 |
Actionability | Concrete, copy-paste-ready tool calls with exact parameters are given for rungs 1–2 (`activity(action="expand", id=N)`, `workflows(action="get", workflowId, full=true)` with the `full=true` flag explained) and for credentials. The gap: `executions` is referenced three times ("`executions` has the detail") but its call syntax is never shown, which keeps this just below anchor 5. | 4 / 5 |
Workflow Clarity | A clearly sequenced escalation ladder ("Read in this order — cheapest first", "Stop at the first one that answers yours") with explicit stop conditions, a question-to-surface decision table, and error-recovery guidance ("An id that no longer resolves is ordinary — carry on rather than treating it as an error"). This is a read-only lookup skill, so the destructive/batch validation cap does not apply. | 5 / 5 |
Progressive Disclosure | Well-organized single-file structure with clear sections, a lookup table, and no nested or dangling references — and all content genuinely belongs inline since it is operational guidance rather than reference material. It scores 4 rather than 5 because the body is ~108 lines, beyond the under-50-line simple-skill exception, and a couple of sections (e.g. the per-surface detail) could live in a reference file if the skill grows. | 4 / 5 |
Total | 18 / 20 Passed |