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 exceptionally well-constructed instruction skill: a nine-step workflow where every step is executable, every fragile operation (scaffold, evals, replay, hosted runs) has an explicit validation loop or stop rule, and detail is correctly deferred to real, clearly-signaled bundle files. The body respects the token budget while remaining copy-paste actionable throughout.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~88-line body contains only steps, rules, and pointers — no explanations of concepts Claude already knows — and dense operational detail (e.g. the Tessl credit stop rule) is decision-critical rather than padded. Anchor 5 ('lean and efficient; every token earns its place') fits better than 4, which requires over-explanation that could be trimmed, and none is evident. | 5 / 5 |
Actionability | Every step carries an executable command — `git log -1 --format=%H --before="<prompt time>"`, `cp -r "$(readlink -f <this skill's folder>)/assets/template/." <new repository>/`, `./scripts/start_skill.sh <name>`, `python3 ./scripts/validate_eval_criteria.py evals evals-reference evals-regression`, `tessl review run --threshold 100 skills/<name>/SKILL.md` — plus concrete numeric rules (at most three runs, 30-point gap, threshold 100). This matches anchor 5 (fully executable, copy-paste ready); anchor 4 would require minor gaps, and the commands are complete. | 5 / 5 |
Workflow Clarity | Nine numbered steps in a clear sequence with explicit validation checkpoints (validate eval criteria 'until it passes', compare the replay against 'the version that stayed', 'fix every finding') and feedback loops ('fix the skill (never the prompt) and replay again'; 'At most three runs per scenario per change; if a run is stuck or a score does not move, stop and report'), ending in a done-check with required reporting. This matches anchor 5; anchor 4 would mean missing or merely implicit checkpoints, and validation is explicit at every stage. | 5 / 5 |
Progressive Disclosure | The body is an overview workflow that keeps detail in four real one-level-deep reference files (all verified present in references/) surfaced through a 'Read it when' table, plus a real assets/template/ bundle whose README is also linked; the references do not chain to further skill documents. This matches anchor 5 (clear overview, well-signaled one-level-deep references, easy navigation) rather than 4, since organization gaps are absent. | 5 / 5 |
Total | 20 / 20 Passed |