Content
81%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 well-engineered orchestration body: lean instruction-only prose, a clearly gated eight-step workflow with validation checkpoints and error fallbacks at every stage, and clean one-level-deep references whose anchors all resolve. The main gaps are a redundant plugin-install paragraph, how-to detail that requires hopping into reference files, and a hard dependency on the absent factory-setup sibling bundle for the timeline and preflight details.
Suggestions
Tighten the step-1 plugin paragraph: the conditions in 'A skill that is still missing, because the user declined, the install failed, or it is not visible after the install' repeat the two preceding sentences and could collapse to one rule.
Inline a one-line example of a routed proposal (tier, evidence line, numbering) so step 5's display format is actionable from the body without opening references/routing.md.
Make the factory-setup dependency explicit at the top and/or duplicate the timeline marks briefly, since the ../factory-setup links (preflight checks, plain-words rule, timeline format, starters) dangle when that sibling skill is not installed.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, instruction-only, and explains nothing Claude already knows, but the step-1 plugin paragraph restates failure conditions ('because the user declined, the install failed, or it is not visible after the install') already covered by the preceding sentences — minor instances that could be trimmed, matching the 4 anchor. It is not 5 because those redundant tokens do not fully earn their place, and not 3 because the verbosity is confined to one paragraph and the rest is lean. | 4 / 5 |
Actionability | Concrete commands appear throughout ('tessl code repo view <owner/repo> --json', 'tessl whoami', 'tessl install -g <plugin>', fetch and compare 'HEAD' with 'origin/<default branch>') plus the exact question to ask ('Do you want me to push this and open a pull request?') and a field to check ('repository.review.enabled'). It is not 5 because the core how-to — building candidate rules, writing tier files, the proposal-list display format — lives entirely in the reference files so the body alone is not copy-paste executable, and not 3 because every delegation is precise, with named sections, anchors, and explicit fallback rules. | 4 / 5 |
Workflow Clarity | Eight numbered steps with explicit validation checkpoints and feedback loops: preflight ('Stop where those checks stop'), a hard gate ('Change nothing in the repository... until the user has picked what to apply in step 5'), spend control ('ask once for one plan with a firm total'), push only on user yes, and error recovery at nearly every step (subagent failure → 'skip the score, tell the user in one line, and go on'; Code Review command failure → 'treat Code Review as off... and continue'; failed install → "'needs <plugin>' items, shown but not applied"). This matches the 5 anchor's clear sequence with explicit validation, error-recovery loops, and checklists. | 5 / 5 |
Progressive Disclosure | The body is a genuine overview delegating to nine references/*.md files, all one level deep; every cited anchor (routing.md#the-proposal-list, apply.md#start-the-branch-step-6, verifiers.md#1-write-one-file-per-rule, lenses.md#backtest, context.md#edit-an-existing-file, scoring.md#re-score-step-8) resolves to a real heading in the bundle, and scripts are reachable via references (scoring.md → scripts/build-report.mjs and scripts/rescore.mjs, evidence.md → scripts/collect-evidence.mjs). It is not 5 because three links point outside the bundle into the sibling factory-setup skill (../factory-setup/SKILL.md, ../factory-setup/references/starters.md, ../factory-setup/references/progress.md), which is not part of this bundle, and the timeline format is delegated wholly to that external file; it is not 3 because within the bundle the structure, signaling, and navigation are clean and complete. | 4 / 5 |
Total | 17 / 20 Passed |