Content
92%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 exemplary workflow skill body: fully executable commands and templates, an eight-phase sequence with validation before edits and an approval gate, a re-review/verify loop, and a well-signaled one-level-deep reference with no orphaned files. The only trimmable fat is the redundant closing Notes section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and instructive — every phase carries directive content with no concept explanations Claude already knows. Minor trims exist: the closing "Notes" section restates points already made in the phases ("Validates syntax/commands before applying", "Uses `tessl review run` for evaluation"), and Phase 8's checklist reiterates Phase 4's items. This fits anchor 4 ("efficient; minor instances of over-explanation that could be trimmed") better than anchor 3, since the repetition is small and the Phase 8 re-check is an intentional verification loop. | 4 / 5 |
Actionability | Fully executable throughout: exact commands with flags (`tessl review run <path-to-skill> --label "baseline"`, `--threshold`, `tessl review fix ... --max-iterations 3 --threshold 85`, `--yes`, `--review-plugin`), a copy-paste-ready orphan-detection bash snippet, an exact recommendation-block template, and a concrete priority-table format — matching the anchor-5 'copy-paste ready commands covering common cases'. | 5 / 5 |
Workflow Clarity | Eight clearly sequenced phases with explicit validation checkpoints and feedback loops: Phase 4 mandates validating syntax/flags/references **before** applying, Phase 6 is approval-gated with minimal conservative edits, Phase 7 re-runs the review and shows before/after score comparison, and Phase 8 re-validates and fixes any issues. This matches the anchor-5 pattern (validate → fix → re-validate, with checklists) that the rubric reserves for batch/edit operations. | 5 / 5 |
Progressive Disclosure | Scored against the actual bundle (SKILL.md + references/REFERENCE.md, which exists): the one reference file is linked exactly once with a strong what/when signal — "See [REFERENCE.md](references/REFERENCE.md) for validation code snippets (Python `ast.parse`, JS `node --check`, bash file-reference checks)" — matching the rubric's ✅ example. It is one level deep, there are no orphaned bundle files, the body teaches orphan/link hygiene itself, and section headers (Workflow phases, Fast path, Customizing, Progressive Disclosure) make navigation easy — matching anchor 5. | 5 / 5 |
Total | 19 / 20 Passed |