Content
85%Weight 40%Scale 1-3Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
A well-structured guided-lesson walkthrough with concrete commands, explicit per-step validation gates, and error-recovery guidance. Its only weakness is token efficiency: the three-part output structure is restated in the per-step checks, the verification list, and the closing takeaway, which a tighter version would consolidate.
Suggestions
Consolidate the three-part output description: state the subheading/inline-comment/unplaced-findings structure once in step 2 and reference it from the 'Verify it's working' and 'When they finish' sections rather than restating all three each time.
Trim tutor-voice justifications that add length without changing the action, e.g. 'so it is explicit here only for clarity' and 'because it frames what the command does'.
The 'Before you start' distinction between tessl review run and tessl change review is valuable domain knowledge; keep it but shorten the framing sentence that introduces it.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is largely lean and never explains concepts Claude already knows, but the same three success criteria (per-skill subheading, inline comments on changed hunks, unplaced findings) are restated three times — in per-step checks, the 'Verify it's working' list, and the closing takeaway — which could be tightened. | 2 / 3 |
Actionability | Provides fully executable, copy-paste-ready commands throughout — 'tessl change review --skill tessl/code-review#review-code-legibility --base origin/main', 'git status', '--json', '--output review.json' — with specific flags explained inline. | 3 / 3 |
Workflow Clarity | Steps 0–3 are clearly sequenced, each followed by an explicit 'Check' gate with instruction to troubleshoot rather than advance, plus targeted error-recovery guidance (empty result, missing --skill, no origin/main). | 3 / 3 |
Progressive Disclosure | No bundle files exist, so disclosure lives entirely in a single well-organized body; sections are clearly headed and the only external pointers (the lesson page and the related CI lesson) are one-level navigational links, not nested reference chains. | 3 / 3 |
Total | 11 / 12 Passed |