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.
A tight, well-sequenced operational skill: concrete CLI commands, a complete finding payload template, explicit confirmation and deduplication checkpoints, and a clear do-nothing terminal state. The only minor gap is the unspecified shape of the update payload (changes.json) used when appending observations to an existing finding.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is lean and assumes competence: every line instructs ('Skip generated code (`genproto/`, `pb/`) ... and agent context (`.claude/`, `.agents/`, `.tessl/`)', 'Leave out `loopId` and `runId`; the service derives them from the scheduled run'). No padding and no explanation of concepts Claude already knows, matching the 'every token earns its place' anchor. | 5 / 5 |
Actionability | Concrete, executable commands are given ('tessl finding list --project $TESSL_PROJECT_ID --limit 100 --json', 'tessl finding create --project $TESSL_PROJECT_ID --file finding.json --json') plus a complete finding.json template. Not a 5 because the update path references '--file changes.json' without showing that payload's shape, a minor gap in otherwise copy-paste-ready guidance. | 4 / 5 |
Workflow Clarity | The six-step procedure is clearly sequenced with explicit validation checkpoints for a batch operation: 'A violation is confirmed when you can quote the rule and point to the line', 'view likely matches before deciding', and a terminal check ('If nothing drifts, create nothing'). Validation is present, so the missing-validation cap does not apply, and the sequence matches the explicit-checkpoint anchor. | 5 / 5 |
Progressive Disclosure | The skill is under 50 lines with no external references needed; the content is split into well-organized sections (header rule, Inputs, Procedure, payload template, Finish). Per the simple-skill guideline, this earns a 5 — all references inside the body (rules/*-standards.md, AGENTS.md/CLAUDE.md chain) are inputs to read at runtime, not skill bundle files, and no bundle directories exist. | 5 / 5 |
Total | 19 / 20 Passed |