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 skill body: dense, executable, and free of padding, with a clearly sequenced multi-step loop containing mandatory verification, feedback loops, and escalation rules, and an appropriately split one-level-deep bundle. The only deduction is for inline time-sensitive model/version pins, which the rubric penalizes unless isolated in a deprecated section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence throughout — every sentence carries non-obvious operational detail (batch waves of 3 for quota, per-pid wait because a collective wait reports only the last status, perl alarm because timeout(1) is missing on stock macOS, ~100 KB brief cap). Not a 5 because time-sensitive version pins ('default: Gemini 3.8 Flash', 'current July 2026') appear inline rather than in a deprecated/old-patterns section, which the rubric flags as a conciseness penalty even though the 'models are knobs' framing partially mitigates it. | 4 / 5 |
Actionability | Fully executable, copy-paste-ready guidance: the worker dispatch is a complete bash snippet (mktemp, env -i, subshell, pid reaping) and the advisor consult is an exact command line with a portable timeout. Specific failure paths (non-zero exit or empty $out → retry via API fallback → no key: ESCALATE) and a concrete status-board format make the common cases fully covered. | 5 / 5 |
Workflow Clarity | The 7-step loop is clearly sequenced with explicit validation checkpoints: tool checks at frame time, two mandatory advisor consults, a verify step with per-result PASS/FIX/ESCALATE verdicts, redispatch on failure ('never hand-patch a substantive failure; redispatch instead'), explicit escalation boundaries, a stated budget rule, and defined stop conditions. This matches the 'clear sequence with explicit validation steps; feedback loops' anchor exactly. | 5 / 5 |
Progressive Disclosure | SKILL.md is a well-organized overview holding the hot path, with three clearly-signaled one-level-deep references (references/worker-brief.md, references/advisor-consult.md, references/fallbacks.md), all of which exist and none of which nest further. The split is appropriate: formats and fallback commands live in the reference files, orchestration logic inline, matching the 'clear overview with well-signaled one-level-deep references' anchor. | 5 / 5 |
Total | 19 / 20 Passed |