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 excellent instruction-only body: the workflow is unambiguous with validation checkpoints and error-recovery loops exactly where a destructive-operation skill needs them, and the guidance is copy-paste concrete. The weaknesses are redundancy (the Contract section deliberately duplicates the body, and key purge rules are stated twice) and a monolithic single-file layout that inlines a long command catalog.
Suggestions
Trim the duplication: the Contract section restates the card, logging, and routing guarantees already given in the body, and the purge/`--confirm-destructive` rules appear in both "When This Fires" and "When it fails" — state each once and cross-reference.
Shorten or cut the "Why This Exists" narrative to its one-line rule ("if it's data and it's bulk, ASK FIRST") since the anti-patterns section already carries the motivation.
Consider moving the gbrain-specific command catalog (purge-deleted, source/mount removal, raw-SQL cases) into a reference file so the routing-critical gate procedure stays lean in SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious operational rules and teaches no concepts Claude already knows, but it carries trimmable duplication: the Contract section restates body guarantees ("this section exists for the conformance test"), "Why This Exists" is narrative motivation, and the purge protocol and --confirm-destructive point each appear in two sections. | 4 / 5 |
Actionability | Fully executable guidance throughout: exact commands ("gbrain pages purge-deleted --dry-run --json", "gbrain get <slug> --include-deleted", "gbrain write-request <request_id>"), a copy-paste confirmation card template, a templated deletion-log entry, and explicit thresholds (10 files, >1GB or >1000 files/pages). | 5 / 5 |
Workflow Clarity | Four clearly sequenced steps with explicit validation and feedback loops for a destructive-operation skill: per-page purge verification ("confirm each one is gone… before the next"), response handling that re-presents the card on questions or "wait", write_pending receipt polling before logging, stop-at-first-refusal, and an interrupted-batch protocol, plus the recoverability checklist. | 5 / 5 |
Progressive Disclosure | Clear section structure with well-signaled, one-level-deep references to shared conventions (ask-user "supplies the stop-and-wait discipline"; test-before-bulk "gates bulk WRITE quality") instead of inlining them. However, the ~35-line gbrain command catalog and purge protocol are inlined in a 230-line single-file body with no bundle files to offload detail into. | 4 / 5 |
Total | 18 / 20 Passed |