Content
96%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 command-first skill body: concrete executable commands with explicit output fields to branch on, a sequenced workflow with real validation and consent checkpoints for a destructive data migration, and lean prose that only contains tool-specific knowledge. The only structural note is that all content lives inline in one file with no reference split, which is defensible at this length but leaves minor room for a Step 3 reference file.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Lean and efficient throughout: every section carries gbrain-specific facts Claude could not know ("effective_engine: null (no brain) → Step 2", "the docker rung needs --allow-docker", "graduation_source_writer_held names the process to stop"), with zero padding and no explanation of concepts Claude already knows. Matches anchor 5; it is not 4 because there is no identifiable over-explanation to trim. | 5 / 5 |
Actionability | Fully executable, copy-paste-ready commands cover every common case: "gbrain engine status --json", "gbrain init --prefer-postgres", "gbrain migrate --to postgres --url-env GBRAIN_TARGET_URL --yes --expect <plan_hash>", "gbrain migrate --status --json", plus the exact JSON fields to branch on (effective_engine, db_url_source, graduation.state). Matches anchor 5; not 4 because no key step lacks its concrete command. | 5 / 5 |
Workflow Clarity | A clearly sequenced 4-step workflow with explicit validation checkpoints and feedback loops for the destructive migration: plan first ("exits 3 with the confirmation_required document"), run only after user consent with "--yes --expect <plan_hash>", "preview_changed means the plan changed: go back to step 2", and post-run doctor verification. The destructive-operation cap at 3 does not apply because validation is thoroughly present; this matches anchor 5, not 4, since every checkpoint is explicit and every failure path names its fix. | 5 / 5 |
Progressive Disclosure | No bundle files exist; the skill is a single ~155-line file with well-organized sections, and the deep migration detail is correctly deferred to a clearly signaled external guide ("Full reference: [Move a PGLite brain to Postgres](...move-to-postgres.md)") plus sibling-skill links. Matches anchor 4 (good structure, references clear, minor organization gaps) rather than 5 because nothing is split across bundle files and the Step 3 sub-procedure is detailed enough that it could live in a reference file; not 3 because structure and signaling are genuinely good, not merely present. | 4 / 5 |
Total | 19 / 20 Passed |