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 CLI-driving skill body: a routing table for discovery, a concrete operating loop with commands, hard rules that state consequences rather than prohibitions, and gotchas that are all non-obvious. Validation checkpoints precede every risky action (launch, merge, cancel) and the structure defers all detail to clearly signaled one-level-deep references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body teaches only non-obvious, Archon-specific behavior ('A detached run starts its own session and survives your shell', 'with dozens it contends for the database') with no padding or explanations of concepts Claude already knows. Every section — routing table, operating loop, hard rules, gotchas — carries information Claude could not infer. | 5 / 5 |
Actionability | Fully executable commands cover the common cases: `archon workflow run <workflow> --branch <branch-name> "<the work>" --detach`, `archon workflow attention --watch --json`, `archon workflow respond <run-id> <decision> "<reason>" --detach`, `archon workflow get <run-id> --json`, and `gh pr merge <n> --match-head-commit <sha>`. Nothing is pseudocode or abstract. | 5 / 5 |
Workflow Clarity | The operating loop is a clear six-step sequence (Discover, Check the brief, Launch detached, Watch once, Answer deliberately, Read the result) with explicit validation checkpoints ('get the user's agreement before launching', 'Read the report before telling the user what the run concluded', 'read the open review threads first' before merge). Destructive operations (cancel, hand-merge) carry consequence warnings and safer alternatives (`end-turn`, match-head-commit), and stalled/failed runs route to troubleshooting — so the destructive-operation cap does not apply. | 5 / 5 |
Progressive Disclosure | The intent-routing table ('The user wants to... | Read') maps every intent to a one-level-deep reference file, and inline pointers cite exact sections ('operate/managing-runs.md, "A stalled turn"'). The body is a lean overview that appropriately defers detail to the referenced files; no content that belongs in a separate file is inlined. | 5 / 5 |
Total | 20 / 20 Passed |