Content
86%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 operationally excellent skill body: executable commands with an inline SOUL template, confirmation gates on every destructive operation, and a best-practice operation table that keeps the overview lean while all detail lives one reference level deep. The only flaw is mild redundancy — the runtime fallback and the Local/controller-managed point are each repeated — which costs a little token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious operational specifics (name regex with Matrix localpart rationale, runtime table, env-var fallback, gotchas) and explains nothing Claude already knows, but the runtime fallback behavior and the 'Local means controller-managed' point are each stated twice, matching anchor 4's 'minor instances of over-explanation that could be trimmed' rather than anchor 5. | 4 / 5 |
Actionability | Guidance is fully executable: a copy-paste-ready `agt create worker --no-wait --soul "..."` command with an inline SOUL template, `agt get workers -o json` for phase polling, a complete `update-worker-config.sh --name --runtime [--model] [--skills] [--mcp-servers]` invocation, and `agt apply -f` for resource tuning — anchor 5's 'copy-paste ready commands covering the common cases'. | 5 / 5 |
Workflow Clarity | Destructive flows carry real checkpoints: the four-input admin confirmation before create, 'Always confirm with admin first' before runtime switches, confirm-not-mid-task before resource changes, polling to `phase=Running`, and a stop-after-two-identical-outputs anti-loop rule — anchor 4 rather than 5 because per-operation error-recovery loops are deferred to the reference docs and some checkpoints (e.g. post-create greeting order) are only implied here. | 4 / 5 |
Progressive Disclosure | The Operation Reference table maps each admin intent to exactly one reference doc and script, all 11 referenced paths exist in the bundle, references are exactly one level deep (no doc-to-doc nesting), and every bundle file not cited in SKILL.md is reachable from a reference doc or script — a clear overview with well-signaled one-level-deep references and easy navigation. | 5 / 5 |
Total | 18 / 20 Passed |