Content
43%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.
The body is rich in non-obvious domain contracts and correctly delegates ownership to specific source/docs files, but it reads as a dense reference wall rather than a navigable, sequenced workflow. Tightening prose and adding explicit checkpoints would materially improve it.
Suggestions
Break the long run-on bullets into shorter rules or a short numbered sequence with explicit validation checkpoints, especially around the rerun budget and the orphan-abort reap operations.
Split the dense collapse-ordering and rerun-lifecycle material into a referenced file (e.g. references/ci-checks.md) and keep SKILL.md as a concise overview with one-level-deep links.
Promote the few actionable commands (e.g. the abort invocation, the test names to run) into a short "How to verify" or "Commands" section so executable guidance is easy to find.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence and does not pad with basic concepts, but the bullets are long run-on sentences crammed with parenthetical asides and inline regression-test lists that could be tightened for clarity. | 3 / 5 |
Actionability | It gives one concrete command ("no-mistakes axi abort --run <id>") and many specific file pointers, but most of the body is declarative contract/rule documentation rather than executable step-by-step guidance. | 3 / 5 |
Workflow Clarity | The content is declarative domain rules rather than sequenced multi-step workflows, and the destructive/batch operations (reruns, orphan abort) lack explicit validate-fix-retry checkpoints, capping workflow clarity below 3. | 2 / 5 |
Progressive Disclosure | There are no skill bundle files and the body is a flat, mostly unsectioned bullet list with inlined dense content, though it does signal where detailed truth lives ("AGENTS.md owns the contract", "user-facing semantics owned by docs/..."). | 3 / 5 |
Total | 11 / 20 Passed |