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.
The content is a tightly structured, action-oriented scaffolding skill: exact commands, an ordered validation ladder with feedback loops, and a real one-level-deep reference bundle that backs every link. The only soft spot is mild verbosity in the First-Principles Gate and some repeated gate-spend guidance.
Suggestions
Collapse the repeated 'do not spend a Tessl live run until internal evidence predicts >=90' / 'do not substitute dry-run for SDK handoff' guidance so it appears once (in Validation) rather than re-stated across the Workflow and template references.
Tighten the First-Principles Gate into a compact checklist; several labeled fields ('Rejected copied assumption', 'Rejected alternatives', 'Fundamental constraints') overlap and could merge without losing the gate's force.
The Validation ladder's step 8 and step 9 Tessl receipts are described twice in the body's prose; keep the canonical wording in the numbered ladder and reference it from the narrative paragraphs.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and avoids explaining concepts Claude already knows, and the Workflow points to the Validation section rather than duplicating it; the First-Principles Gate's many labeled fields and some repeated fail-fast/Tessl-spend guidance could still be trimmed. Efficient with minor instances of over-explanation. | 4 / 5 |
Actionability | Provides copy-paste-ready exact commands ('./bin/ask skills audit <skill-path> --level strict --json --robot'), concrete file paths for the minimal package, and a complete output YAML template covering the common cases. | 5 / 5 |
Workflow Clarity | A 10-step numbered Workflow is clearly sequenced with explicit validation checkpoints ('Run strict audit. If it fails, fix that failure before broader validation'), a dedicated ordered gate ladder, explicit fail-fast feedback loops, and blocked-plan handling for read-only runners. | 5 / 5 |
Progressive Disclosure | The body is an overview that signals one-level-deep references via links ('[evidence discovery](./references/evidence-discovery.md)', '[skill template](./references/skill-template.md)', '[examples](./references/examples.md)'), and the bundle confirms all referenced paths (contract.yaml, evals.yaml, task-profile.json, discovery-interview.md, evidence-discovery.md, examples.md, skill-template.md) are real files in references/. | 5 / 5 |
Total | 19 / 20 Passed |