Content
50%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 is well-structured and offers genuinely executable setup snippets, but it is overlong for a SKILL.md, lacks validation checkpoints around the evolve step, and critically references core scripts (observe.sh, Python CLI) that are not bundled. Splitting detail into reference files and shipping the missing scripts would lift every dimension.
Suggestions
Bundle the referenced observe.sh, hooks/hooks.json, and Python CLI under scripts/ (or references/) so the runtime the body describes actually exists.
Add an explicit validation/feedback checkpoint to the evolve workflow (e.g. review generated instincts, confirm confidence before promoting to evolved/), since clustering into skills/commands/agents is a batch operation.
Move the full config reference, command catalog, and architecture rationale into separate reference files and keep SKILL.md as a lean overview with one-level-deep links; fix the broken ```json fence in the plugin-install section.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient with concrete config/commands, but sections like the v1/v2 comparison table and the 'why hooks not skills' rationale explain design history Claude does not need to act, and could be trimmed. | 3 / 5 |
Actionability | Inline guidance is concrete (settings.json hooks, mkdir, config.json, instinct YAML, slash commands), but the system's core runtime — observe.sh, hooks/hooks.json, and the Python CLI — is referenced yet absent from the bundle, leaving a key execution gap. | 3 / 5 |
Workflow Clarity | The quick start is sequenced (enable hooks → init dirs → use commands), but no validation or feedback checkpoints exist for the batch-like evolve/clustering operation, capping workflow clarity at 3; a malformed ```json fence in the plugin-install section also muddies the steps. | 3 / 5 |
Progressive Disclosure | Section headers give reasonable structure, but the ~250-line SKILL.md is monolithic with config reference, command docs, and architecture all inlined, and it references bundle files (scripts/references) that do not exist. | 3 / 5 |
Total | 12 / 20 Passed |