Content
81%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.
A strong orchestration-skill body: concrete paths, commands, and assertion names throughout; two clearly sequenced workflows with confirmation checkpoints, validation, and a triage-driven feedback loop; and a well-organized one-level-deep reference structure. The main gaps are an orphaned bundle file, some duplicated guidance that could be trimmed, and the absence of even a minimal inline assertion example.
Suggestions
Reference references/multi-test-directories.md from the Reference Files table (or remove it) — it currently exists in the bundle but is unreachable from SKILL.md.
Deduplicate the valid command-prefix list and the reach-claim guidance, each of which appears twice or three times across Definitions, Recommended Workflows, and Self-Review.
Add a 3-5 line inline example of a typical SDK assertion (e.g. an Always and a Sometimes reach claim) so the core artifact is concrete without leaving SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is imperative and dense, defining only Antithesis-specific concepts ("SUT", "Timeline", assertion types) rather than things Claude already knows. Minor over-explanation to trim: the valid command prefixes are listed twice (Definitions and Self-Review) and the reach-claim guidance is stated in workflow step 9 and twice more in Self-Review — anchor 4, not 5. | 4 / 5 |
Actionability | Highly concrete for an instruction-only skill: exact paths ("antithesis/scratchbook/properties/{slug}.md", "/opt/antithesis/test/v1/{name}/"), exact command prefixes, named SDK assertions, runnable commands ("snouty validate", "snouty docs"), and a worked bounds example ("counter changed by some value in `[acknowledged, attempted]`"). Anchor 4, not 5: no inline example of an actual assertion despite assertions being the core output artifact. | 4 / 5 |
Workflow Clarity | Two numbered workflows with a hard user-confirmation checkpoint, "DO NOT PROCEED" prerequisite guards, and an explicit feedback loop (run via antithesis-launch, triage via antithesis-triage, unfired reach claims as the iteration signal), plus a Self-Review checklist and "snouty validate". Matches anchor 5: clear sequence, explicit validation, error-recovery loops, and a checklist. | 5 / 5 |
Progressive Disclosure | The body is a genuine overview with a well-signaled one-level-deep Reference Files table (file + "when to read"), and workflows point to specific references at specific steps; all five referenced files exist. Not 5: references/multi-test-directories.md (135 lines) exists in the bundle but is never referenced from SKILL.md, leaving it unnavigable. | 4 / 5 |
Total | 17 / 20 Passed |