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.
An exemplary operational skill body: an ordered lookup chain with explicit stop conditions, executable commands at every step, a validated batch ingest pass, error-recovery guidance, and clearly signaled one-level-deep cross-references. The only real weaknesses are mild rhetorical padding and a monolithic single-file layout where a reference file could offload the ingest-resolution detail.
Suggestions
Trim the motivational framing ('The Bug This Kills' anecdotes, 'The Standard' section) to their one-line essences — the contract and anti-patterns sections already carry the same enforcement signal.
Move the ingest-resolution detail (post-ingest pass, domain-shortcut table, batch sizing) into a references/ file (e.g., references/ingest-resolution.md) and keep a short summary plus clearly signaled link in SKILL.md, taking advantage of progressive disclosure the bundle currently doesn't use.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with operational content — commands, thresholds, a domain-shape table, anti-patterns — with only minor trimmable framing such as the 'The Bug This Kills' anecdotes and the rhetorical 'The Standard' closer. Efficient with minor instances of over-explanation (anchor 4), not 5 (the motivational sections don't strictly earn their tokens) and not 3 (there is no padding that teaches concepts Claude already knows). | 4 / 5 |
Actionability | Fully executable throughout: copy-paste-ready commands ('gbrain think "Who is {entity}?..."', 'gbrain search "{entity}" --limit 5', 'gbrain timeline {entity-slug} --limit 20'), exact placeholder markers to scan for ('[To be filled', 'Unknown relationship', 'TBD'), concrete batch parameters ('batches of 10–20', '100+ pages'), and a complete escalation output template — specific examples cover the common cases. | 5 / 5 |
Workflow Clarity | The six-step chain is explicitly ordered with 'STOP at the first clear answer' validation checkpoints, confidence thresholds define the stop/ask decision, the post-ingest batch pass opens with a validation/skip check (step 1 placeholder scan) plus a quality-bar acceptance test, and 'When it fails' provides a feedback loop ('revision_conflict: re-read and merge'). The batch-operation cap does not apply because validation and recovery steps are present. | 5 / 5 |
Progressive Disclosure | Thirteen clearly headed sections with sibling-skill references (../conventions/brain-first.md, ../ask-user/SKILL.md, ../query/SKILL.md, etc.) that are one level deep and well-signaled via the top convention blockquotes and the sharp-boundary Dedup section. However, no bundle files exist (no references/, scripts/, or assets/), so all ~290 lines are inline — the ingest batch mechanics and domain-shortcut table could live in a separate reference file — which keeps it below the top anchor and outside the under-50-line simple-skill exception. | 4 / 5 |
Total | 18 / 20 Passed |