Content
77%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 delivers exceptional actionability and a well-sequenced, validated workflow with a thorough error-recovery catalog. Its weaknesses are repetition of the wrapper guidance across four sections and a monolithic structure with no bundle files, where two of the deep-dive sections belong in separate references.
Suggestions
Move the managed-brain recipe and the multi-source consolidation details into a reference file (e.g. references/managed-brain.md) and keep a one-line pointer plus the decision rule in SKILL.md.
State the GBRAIN_HOME/wrapper rule once (in the Contract or Phase 6) and have the other sections reference it instead of restating it.
Collect version-dependent notes (v0.11.0 auto-rewrite, v0.40.3.0+ per-source locks) into a short "Version notes" or deprecated-patterns section so they don't bloat the main flow.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly dense, non-obvious operational knowledge, but the wrapper/GBRAIN_HOME point is restated in the Contract, Phase 6, "When it fails", and Anti-Patterns sections, and inline version pins ("v0.11.0", "v0.40.3.0+") are not isolated in a deprecated section, which the guidelines penalize. Repetition exceeds the "minor instances" of anchor 4. | 3 / 5 |
Actionability | Fully executable throughout: copy-paste-ready cron lines for both classic and managed brains, exact diagnostic commands ("gbrain doctor --only cron_gbrain_home", "gbrain sources writer status --json"), and concrete error codes each paired with a specific remediation command. | 5 / 5 |
Workflow Clarity | Six numbered phases with explicit validation checkpoints (collision check against a listed slot set, test-on-3-5-items-first convention, idempotency requirement), and the "When it fails" section provides feedback loops for every failure mode, including batch/destructive cron operations. | 5 / 5 |
Progressive Disclosure | The bundle contains no reference or script files; the entire ~160-line body is inline, and long sections (managed-brain recipe, multi-source consolidation, failure catalog) are candidates for one-level-deep reference files. External paths ("skills/conventions/...", "../conventions/...") are clearly signaled but unverifiable within the bundle — matching anchor 3 rather than 4. | 3 / 5 |
Total | 16 / 20 Passed |