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.
The body is a dense but disciplined procedure: nine ordered steps, each with concrete commands, named files, explicit validation and feedback loops, stop rules against retry spirals, and a closing completion checklist. Detail is pushed to four real, leaf-level reference files that are precisely signaled by a read-it-when table, and the only mild pressure point is step 8's packed paragraph, though every clause in it is operational (usage gate, fallback screen, score threshold, retry cap).
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body assumes Claude's competence throughout and spends tokens only on non-obvious operational knowledge, e.g. "copy everything under assets/template/ into that directory with cp -r, from the resolved path of this skill (readlink -f), because an installed skill is usually a symlink" and "never retype the template by hand, which loses file modes and invites typos". There is no explanation of concepts Claude already knows; the only candidate for trimming (the short intro) defines terms ("the version that stayed") used by later steps, so it earns its place. | 5 / 5 |
Actionability | Every step carries executable commands or exact edit targets: "git log --before", "cp -r", "git init", "python3 scripts/validate_eval_criteria.py evals evals-reference evals-regression", "tessl project create <name> --workspace <workspace>", "tessl org usage --json", and "scripts/local_screen.sh", along with the named files to edit (tessl.json, .tessl-plugin/plugin.json, README.md). Commands are copy-paste ready and cover the common cases; per the rubric's instruction-skill note, this is fully actionable. | 5 / 5 |
Workflow Clarity | The nine-step sequence is clearly ordered with explicit validation checkpoints and feedback loops: "Run python3 scripts/validate_eval_criteria.py ... until it passes", "If it differs in the habit the skill teaches, fix the skill (never the prompt) and replay again", and the credit gate "if credits.overLimit is true or credits.remaining is below the run's estimate, do not run it". A stop rule ("At most three runs per scenario per change; if a run is stuck or a score does not move, stop and report") and a closing done-check ("The task is done when the replay produces the version that stayed, every with-skill scenario scores 100...") complete the error-recovery loop. | 5 / 5 |
Progressive Disclosure | The body is a lean overview with a References table that signals exactly when to open each file ("You need the session transcript on disk", "You write or revise SKILL.md"); all four references/ files exist and contain no further links, so navigation is one level deep. Every path cited from the bundle (assets/template/README.md, scripts/validate_eval_criteria.py, scripts/local_screen.sh, docs/agents/local-screening.md) exists in assets/template/, matching the anchor for a clear overview with well-signaled one-level-deep references. | 5 / 5 |
Total | 20 / 20 Passed |