Content
96%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 exceptionally dense, actionable skill body: exact commands, known-tool-failure warnings, precise output formats, and an explicit error-recovery path, all with zero padding. The only structural blemish is the reference to a script file that is not present in the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every line carries non-obvious operational knowledge Claude could not infer ("Do not use `bk job log` — it hangs indefinitely", "`slack_send_message` does NOT support markdown tables", chunk limit "under 4800 chars"). No concept explanations or padding; it assumes competence and matches anchor 5 ("lean and efficient; every token earns its place") rather than anchor 4's "minor instances of over-explanation". | 5 / 5 |
Actionability | Copy-paste ready commands with variants (`bun run ci:slowest 47324 100`, `--json`), exact fallback commands (`gh pr list --state merged --limit 10 --json number,headRefName`, `bk build list --branch <headRefName>`), a concrete gist command, and a fully specified output row format. Anchor 5 ("fully executable; covers the common cases") fits. | 5 / 5 |
Workflow Clarity | Two clearly sequenced phases with explicit gating ("only if a channel was given") and a numbered Slack procedure. An error-recovery feedback loop exists for the primary failure mode ("If the script can't find a build automatically... pick one yourself" with exact commands), and chunk posting is ordered ("Post chunks sequentially so they stay ordered"). This matches anchor 5 ("clear sequence... feedback loops for error recovery"); the destructive/batch cap does not apply since this is read-only data gathering plus non-destructive posting with recovery paths. | 5 / 5 |
Progressive Disclosure | The body is under 50 lines, well-sectioned (Gather the data / Post to Slack), and needs no external reference files — close to the simple-skill ideal of a 5. It drops to 4 because it references "the script (`scripts/ci-slowest-tests.ts`)" while no scripts/ directory (or any bundle file) exists in the skill, leaving a dangling path that the reader cannot resolve. | 4 / 5 |
Total | 19 / 20 Passed |