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 procedural skill body: exact script contracts, copy-paste templates, a fully specified validation-and-retry lifecycle, and disciplined conditional loading of one-level-deep references. The only weakness is mild redundancy in the approval-semantics rules and a few sentences that could be tightened.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, procedural, and teaches no known concepts — every sentence states a bespoke rule (script contracts, approval semantics, batch eligibility). It sits at 4 rather than 5 because approval rules recur across several phrasings ("Only a new user message explicitly approving the latest displayed create_plan.py result permits Build", "earlier approval does not carry over", "A saved plan is not evidence of user approval") and a few long sentences could be tightened without loss. | 4 / 5 |
Actionability | Guidance is fully executable: a complete copy-paste-ready create_plan JSON payload, the script-interface table with exact input and result fields per operation, a YAML frontmatter template, exact enum values ("instruction/template/workflow", "off/smoke/eval"), and a fully specified user-facing options table. Nothing is pseudocode or hand-wavy, matching the top anchor. | 5 / 5 |
Workflow Clarity | The lifecycle is clearly sequenced (Plan → approval → init_draft → author → validate → test → publish) with explicit validation checkpoints and feedback loops: "Fix reported static or security errors in the draft and validate again" and "When a test or Batch run fails, retain the draft, report the concrete error, revise the Skill if the correction is clear, then validate again". Error paths like missing-plan and name conflicts are handled, matching the top anchor including its feedback-loop requirement for batch operations. | 5 / 5 |
Progressive Disclosure | The body is a clear overview with well-signaled, verified, one-level-deep references (type-and-package.md, behavior-testing.md, run-batch.md all exist, none nest further), and disclosure is explicitly conditional: "Read [primary type and package]... then choose one primary type" and "Only after selecting batch: true, read [run batch]... When batch: false, do not read it". Bulk detail is correctly deferred to scripts and references rather than inlined. | 5 / 5 |
Total | 19 / 20 Passed |