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 highly actionable, well-sequenced enrichment protocol with genuine validation and error-recovery loops appropriate to a batch, page-mutating skill. The only notable gap is structural: the single long file inlines template and version-specific detail that would sit better in one-level-deep reference files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational — tables, a 7-step protocol, and templates with no explanations of concepts Claude already knows. Minor tightening is possible: "Don't overwrite user-written assessments with API boilerplate" appears in both the UPDATE path and Validation Rules, and a few prose passages (e.g., the Communication Style guidance) could be trimmed. | 4 / 5 |
Actionability | Guidance is copy-paste ready: exact commands (`gbrain search "name"`, `gbrain schema show --json`, `gbrain sweep --once`, `gbrain timeline-add`), a concrete put_raw_data JSON payload, complete person/company page templates, and quantified validation thresholds ("Connection count < 20"). Flexible-tool mentions ("Perplexity, Brave Search, Exa, or equivalent") are appropriately justified since external APIs vary. | 5 / 5 |
Workflow Clarity | The 7-step protocol is clearly sequenced with CREATE/UPDATE branch points, and this batch skill has real validation and feedback loops: test on 3–5 entities before bulk, commit every 5–10 entities, Validation Rules for wrong-person detection, and a "When it fails" section with explicit recovery steps (revision_conflict re-read/merge/resave, auto_links.errors fix via add_link). | 5 / 5 |
Progressive Disclosure | References to filing rules, conventions, the taxonomist skill, and the agent-operator protocol are clearly signaled via blockquote callouts and one level deep, and sections are well organized. It stops short of a 5 because everything lives in one ~354-line file — the full page templates and the v0.10.1 auto-link mechanics note are candidates for separate reference files. | 4 / 5 |
Total | 18 / 20 Passed |