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.
An exemplary operational skill body: dense with exact commands and gotchas, a clearly sequenced change workflow with validation before publish and verification after merge, and heavy reference material correctly pushed to a well-signaled features.md. No padding or over-explanation was found.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Every clause encodes a non-obvious operational fact, exact command, or failure mode (e.g. "A run started with `tessl launch skill` belongs to no Loop, so Tessl refuses its findings"), and nothing explains concepts Claude already knows. Repeating "ask before each write" across Invariants and step 3 is deliberate safety reinforcement, not padding. | 5 / 5 |
Actionability | Copy-paste-ready commands with placeholders cover every case: `tessl doctor --automations`, `tessl code repo update <owner/repo> --org <org> --review-trigger every-push|open-and-command`, `gh api users/<login> --jq .id`, `tessl schedule trigger <loop id>`. The two deferred spots (web-app key addition, customize.md for skill edits) are constrained by reality and still state the decision rule and follow-up check. | 5 / 5 |
Workflow Clarity | Clear read -> change -> check-and-publish sequence with explicit validation checkpoints at each risky step: doctor before push, cloud check before merge when the hook changed, `view` command after a setting, and Loops confirmation after merge with a recovery path ("if it still is after 10 minutes, tell the person... and do not say it is stopped"). Ask-before-write gates and the what-it-costs/how-to-undo report close the loop. | 5 / 5 |
Progressive Disclosure | The bulky feature catalog is properly split into the real references/features.md, and a dedicated section ("The references you build on") lists every cross-skill reference with what it holds (starters, triggers, setup hook, cloud check, confirm-loops, customize). All references are one level deep, clearly signaled, and the body keeps only the overview, invariants, and the change procedure itself. | 5 / 5 |
Total | 20 / 20 Passed |