Content
96%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 instruction body: fully executable commands, a clearly sequenced fork-or-scratch workflow with an explicit validation feedback loop and error-recovery table, and no filler. The only minor gap is progressive disclosure — the long inline rubric template could be split into a reference file, which is what separates it from a perfect score.
Suggestions
Move the minimal rubric JSON template (Step 4, Path B) into a one-level-deep reference file (e.g. references/rubric-template.json) and link to it, trimming the inline body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes Claude's competence: no space is spent explaining what Tessl, rubrics, or plugins are; every section (tables of weights, bash scaffolding blocks, the rubric template) is load-bearing instruction. It matches the 'every token earns its place' anchor rather than the level below, where trimming would still be needed. | 5 / 5 |
Actionability | Guidance is copy-paste executable throughout: the mkdir/curl/cp scaffold commands, heredoc-quoted plugin.json and config.json writers, a complete minimal rubric JSON template, the exact 'tessl review run' validation command, and a healthy-output checklist. It fully matches the 'copy-paste ready, covers the common cases' anchor. | 5 / 5 |
Workflow Clarity | Six clearly sequenced steps with decision points up front (fork vs scratch, judge count/weights with an explicit weight invariant), an explicit validation step (Step 6) with expected healthy output, and a feedback loop: 'If the plugin fails validation... Fix the relevant file and re-run', backed by a Common problems table for error recovery. This matches the top anchor with validation checkpoints and error-recovery loops. | 5 / 5 |
Progressive Disclosure | The single-file body is well organized with clear sections, and it correctly points to the canonical default rubric via an on-demand fetch instead of bundling a copy. However, the ~45-line inline rubric JSON template (and to a lesser extent the SKILL.md-customisation guidance) is content that could live in a one-level-deep reference file for a skill of this length, so it fits the 'good structure, minor organization gaps' anchor rather than the perfectly-split top anchor. Not a 3 because nothing is buried: every section is clearly signaled and nothing belongs to a second-level reference. | 4 / 5 |
Total | 19 / 20 Passed |