Content
63%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 substantive, largely actionable instruction body with sequenced phases, a real batch-validation loop, and concrete gbrain commands. Its weaknesses are repetition of the same mandates across five sections, and a monolithic single-file layout whose key referenced files are missing from the bundle.
Suggestions
State the Iron Law / back-link rule once (e.g., in the Contract) and reference it from Phases, Quality Rules, and Anti-Patterns instead of restating it verbatim five times; likewise deduplicate the citation and raw-source-preservation mandates.
Move the per-format media workflows (articles, videos/podcasts, PDFs, screenshots, meetings, social) into a bundled reference file (e.g., `references/media-workflows.md`) and keep one-line summaries with links in SKILL.md, so the overview stays lean.
Bundle `skills/_brain-filing-rules.md` (or inline its notability gate and filing directory map), since multiple mandated steps currently depend on a file the skill does not ship.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with domain-specific rules rather than explanations of known concepts, but the same rules are repeated heavily: "An unlinked mention is a broken brain" appears verbatim in both the Contract and Anti-Patterns sections, the back-link/Iron Law rule is restated roughly five times, citation requirements are stated twice, and "Test Before Bulk" ends with rhetorical padding ("The marginal cost of testing 3 items first is near zero..."). This matches the anchor for mostly efficient content that could be tightened; it is above anchor 2 because the bulk is substantive, not filler. | 3 / 5 |
Actionability | Concrete commands and formats are given throughout: `gbrain search "name"`, `gbrain put <type/slug>`, `gbrain sync --no-pull --no-embed`, `gbrain files upload-raw <file> --page <page-slug> --type <type>`, explicit `[Source: ...]` citation templates, a `.redirect.yaml` example, and a copy-paste output format block. Minor gaps keep it below 5: "Fetch content (`web_fetch` or equivalent)" is ambiguous, and the notability gate defers to a filing-rules file not present in the bundle. | 4 / 5 |
Workflow Clarity | Phases 1-6 are explicitly numbered, the entity-detection protocol is stepwise, and the "Test Before Bulk" section supplies a genuine validate -> read output -> fix -> retry loop for batch operations, so the batch-validation cap does not apply. It sits at anchor 4 rather than 5 because individual write operations (back-link creation, entity page updates) have no verification checkpoint. | 4 / 5 |
Progressive Disclosure | Sections are well organized and references are clearly signaled (the top filing-rule blockquote and inline mentions), but the bundle contains no reference files — the repeatedly cited `skills/_brain-filing-rules.md` and `skills/conventions/quality.md` are not present — and roughly 100 lines of per-format media workflows plus the citation format spec are inlined in a single ~290-line file. This matches the anchor for some structure with content that should be separate left inline; not 4 because the load-bearing referenced material is unavailable and split-out candidates remain inline. | 3 / 5 |
Total | 14 / 20 Passed |