Content
88%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 high-quality procedural skill body: fully executable commands, a tightly sequenced multi-phase workflow with validation and retry loops, and efficient prose that assumes Claude's competence. The main improvement opportunities are tightening the run-label example list and moving reference-style lookup material into a separate file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is command-first and assumes competence — no space is spent explaining what evals or models are, and warnings are one sentence each ("running evals from there won't work and changes would be overwritten"). It is not a 5 because the Run labels section spends ~20 lines on label-composition ingredients and six example labels that could be compressed to two lines. | 4 / 5 |
Actionability | Every phase gives copy-paste-ready bash commands with concrete flags (`tessl eval run <path> --agent=claude:<model> --label <run-label>`, `tessl eval view <id> --json`, `tessl eval retry <id>`), plus exact output formats to parse (`Eval run started: <id>`, `Status: ✔ Completed`) and rendered table templates for the reports. The common cases are fully covered. | 5 / 5 |
Workflow Clarity | Phases 1–7 are clearly sequenced with explicit checkpoints: verify scenarios and login before running (1.2, 1.3), poll each run to Completed/Failed before starting the next model (Phase 4), retry on failure (`tessl eval retry <id>`), and a "When to stop" section. This is a batch, cost-incurring operation and the feedback loop (poll → fail → retry → re-check) plus the explicit warning against concurrent runs satisfies the validation requirement. | 5 / 5 |
Progressive Disclosure | The body is well-organized into clearly headed phases with a navigable overview, and it appropriately points to sibling skills (setup-skill-performance, optimize-skill-performance) rather than duplicating them. It is not a 5 because there is no bundle at all and ~220 lines of inline reference-style material (six label examples, four failure-pattern definitions, table templates) could live in a one-level-deep reference file. | 4 / 5 |
Total | 18 / 20 Passed |