Content
88%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 dense, highly actionable operations manual: concrete CLI commands, ready-to-use page templates, explicit validation gates, and error-specific recovery paths for batch enrichment. Its weaknesses are minor — duplicated rules across sections and inlined templates that could live in separate reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is imperative and dense with almost no explanation of concepts Claude already knows, but contains some redundancy: 'Don't overwrite user-written assessments with API boilerplate' appears in both Validation Rules and Anti-Patterns, and the back-linking rule is stated in the Contract, a blockquote, and Step 7's note. Anchor 4: efficient with minor instances that could be trimmed; not 5 because of the duplicated rules. | 4 / 5 |
Actionability | Concrete commands appear throughout ('gbrain search "name"', 'gbrain lint', 'gbrain wanted', 'gbrain sweep --once', 'gbrain timeline-add'), alongside copy-paste-ready person and company page templates and a JSON example for put_raw_data. Anchor 5: fully executable, copy-paste-ready guidance covering the common create and update cases. | 5 / 5 |
Workflow Clarity | The 7-step protocol is clearly sequenced with CREATE/UPDATE branches, and validation is explicit: notability gate, 'gbrain lint' flags empty sections, 'Test on 3-5 entities first. Read actual output. Check quality.' before bulk runs, 'Commit every 5-10 entities', and a 'When it fails' section with error-specific recovery (revision_conflict re-read/merge/save, rate_limited back-off, auto_links.errors slug fix plus add_link). Anchor 5: clear sequence, explicit validation checkpoints, and feedback loops for batch operations. | 5 / 5 |
Progressive Disclosure | No bundle files ship with the skill; the cross-skill references ('skills/_brain-filing-rules.md', 'skills/conventions/quality.md', 'skills/brain-taxonomist/SKILL.md', '../conventions/agent-operator-protocol.md') are one level deep and clearly signaled via blockquote callouts. The two full page templates (~90 lines) are inlined rather than split into reference files, which fits anchor 4's 'minor organization gaps' rather than 5's clean overview-plus-references split. | 4 / 5 |
Total | 18 / 20 Passed |