Content
75%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 lean, rule-dense contract skill with strong progressive disclosure and explicit validation-before-effect guidance. The main gaps are trimmable meta-procedure (the version-check protocol), a few abstract bullets without a worked example, and cross-bundle links that cannot be verified from the skill itself.
Suggestions
Move the ~20-line 'read-only version check' protocol into a short reference file (or compress it to 3-4 lines in the body) so the main body spends its token budget on the request contract itself.
Add one small worked example for the core contract (a single request showing input/info/instruct/output placement) to ground the abstract bullets like 'Derive a general invariant and test contrasting cases'.
Replace or qualify the two out-of-bundle links (../agently/references/context-and-skills.md, ../agently-collaboration/SKILL.md) with paths that resolve from this skill root, so navigation is fully verifiable within the bundle.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, normative rule-writing with no padding and no explanations of concepts Claude already knows; nearly every bullet adds framework-specific policy. It is not anchor 5 because the ~20-line 'First use: read-only version check' protocol is trimmable meta-procedure that spends tokens on a check rather than the skill's core competence, but that alone is minor, keeping it at anchor 4 rather than dropping to 3. | 4 / 5 |
Actionability | Concrete, executable guidance is present: exact API shapes ('.image(question=..., file=...|url=...|files=[...]|urls=[...])', '.auto_continue()', the '.input(...) .info(...) .instruct(...) .output(...)' chain order, '[[ref:<ref_id>]]' citations) plus per-concern routing to reference files. It is not anchor 5 because several bullets remain abstract principles ('Derive a general invariant and test contrasting cases', 'Prioritize developer understanding') with no worked example inline, and full executable detail is deferred to references. | 4 / 5 |
Workflow Clarity | For a contract/policy skill, the sequence is clear: routing rules to the right sibling skill, a canonical request chain order, and explicit validation checkpoints ('Validate schema, offered keys, authorization, and deterministic constraints before a real call or side effect') with failure recovery ('After measured schema/ensure/length failures, consider a shallower model-facing projection ... '). It misses anchor 5 because there is no end-to-end sequenced workflow with feedback loops; the checkpoints are distributed across bullets rather than forming an explicit ordered process. | 4 / 5 |
Progressive Disclosure | The 'Read by Need' section is a well-signaled, one-level-deep map from each concern to a specific reference file, and all eight cited references/ files exist in the bundle. It falls short of anchor 5 because two navigation links leave the bundle to sibling skills that do not resolve in this package copy ('../agently/references/context-and-skills.md', '../agently-collaboration/SKILL.md'), making part of the navigation unverifiable from the skill root. | 4 / 5 |
Total | 16 / 20 Passed |