Content
73%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 body is a strong operational skill document: a clearly sequenced pipeline, concrete gbrain commands, an explicit quality checklist, model-selection guidance with a spot-check feedback loop, and detailed error-recovery behavior for a mutating batch operation. Its main weakness is token efficiency — the conformance-test boilerplate sections, a duplicated link rule, and an embedded version literal could be trimmed without losing any operational value.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The operational core is tight, but there is noticeable padding: the 'Contract' and 'Output Format' sections literally state they exist 'for the conformance test' rather than for the agent, the 'Link convention' section repeats the quality-bar checklist item ('standard markdown links ... NOT [[wiki-links]]'), 'Related skills' duplicates the convention pointers at the top, and a version literal is embedded ('It does NOT ship a deterministic CLI command in v0.25.1'). This matches anchor 3 ('mostly efficient but includes some unnecessary explanation or could be tightened') better than anchor 4, since these are several trimmable spots, not just minor instances. | 3 / 5 |
Actionability | Concrete, executable guidance dominates: 'gbrain query "needs_enrichment: true type:article" --limit 50', 'gbrain get media/articles/<slug>', a quality bar with numeric thresholds ('≥3 verbatim quotes', '≥3 bullets'), a model-selection table, and specific error remedies ('poll gbrain write-request <request_id>'). It falls short of anchor 5 because steps 3-5 of the Invocation are comment stubs — '# 4. Write the enriched page / Use the put_page operation' — without the actual command syntax for put_page or the cross-link back-link operation. | 4 / 5 |
Workflow Clarity | The 6-step pipeline (READ → SCAN → CONTEXT → ENRICH → WRITE → CROSS-LINK) is clearly sequenced, and validation is explicit: a quality-bar checklist ('An enriched page passes if it has: ✅ ...'), a validate→fix feedback loop for the batch case ('do a Sonnet draft pass and spot-check 5 with the LLM-judge brain-quality eval. If quotes are paraphrased, switch to Opus'), error-recovery steps ('revision_conflict ... Re-read, re-apply ... never overwrite blind'), and an idempotency guard ('check the needs_enrichment flag ... skip if already false'). This matches anchor 5's 'explicit validation steps; feedback loops for error recovery; checklists'. | 5 / 5 |
Progressive Disclosure | Structure is good: a concise overview ('What this does', 'When to invoke') with clearly signaled one-level-deep references at the top ('see conventions/quality.md for citation rules, verbatim-quote requirements, and back-link enforcement'), deferring citation/filing/operator-protocol detail to separate files. It is not anchor 5 due to minor organization gaps: the test-only 'Contract' and 'Output Format' tail sections add noise, 'Related skills' repeats the top pointers, and the referenced paths sit outside this skill's bundle with no references/ directory of its own. | 4 / 5 |
Total | 16 / 20 Passed |