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 excellent instruction-only skill body: every line encodes non-obvious domain rules, the workflow is fully sequenced with validation checkpoints and error-recovery loops, and adapter detail is properly pushed into three well-signaled one-level-deep reference files. The only trimmable fat is the maintainer-only shared-block comment and some redundancy between Quality Checks and Failure Modes.
Suggestions
Move the maintainer parity-script instructions out of the agent-visible body (e.g. into a build note or the maintainers' source only) — the published copy pays their tokens for zero runtime value.
Merge the Quality Checks list with the Failure Modes table (symptom = failed check) to remove the overlap between the two sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with domain-specific rules Claude could not know (sync classes, Goose ownership rules, familiarity wording) and wastes nothing on concept explanations. Not 5 because two parts cost tokens without runtime value for the agent: the maintainer-only HTML comment block about the parity script, and the Quality Checks list partially duplicating the Failure Modes table. | 4 / 5 |
Actionability | Fully actionable for an instruction-only skill: a question→read decision table, a connection-class→what-to-say table, six numbered rules with edge cases resolved (null ≠ 0, RASD framing), a 4-point reply shape, and a worked example reply. Every instruction is executable without inference. | 5 / 5 |
Workflow Clarity | Clear 4-step sequence (pick read → check connection → answer by the six rules → shape the reply) with explicit validation checkpoints: a Quality Checks checklist, a feedback loop for clipped results ("narrow the window... and read again. Never answer from a clipped result"), page-completeness checks before ranking, and a Failure Modes symptom→cause→fix table. Read-only skill, so the destructive/batch cap does not apply. | 5 / 5 |
Progressive Disclosure | Clean overview-plus-references structure: three mode files (gooseworks-adapter.md, direct-meta-adapter.md, planning-only.md) are real, clearly linked from the mode-selection list, and exactly one level deep — verified: they reference only `ads/` data docs, not further skill files. The body retains only mode-independent rules; all adapter-specific detail is correctly split out. | 5 / 5 |
Total | 19 / 20 Passed |