Content
50%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
The body is well-organized and offers genuinely concrete commands and config, but it is verbose for a SKILL.md, keeps all reference material inline instead of splitting it out, and depends on an observe.sh script that is not shipped in the bundle.
Suggestions
Move stable reference material (file structure, scope-decision guide, version-comparison tables, confidence-score table) into separate reference files and link to them one level deep, keeping SKILL.md a lean overview.
Ship the referenced `observe.sh` (or correct the hook paths to a script that exists in the bundle) so the documented hook configs are actually executable.
Add explicit validation/checkpoint steps to the learning workflow — e.g., a verify step after observation analysis and before instinct creation, mirroring the existing --dry-run gate on promote.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~355-line body is mostly relevant operational guidance but includes lengthy conceptual material (version-comparison tables, an ASCII architecture diagram, the "why hooks vs skills" rationale, and a full scope-decision guide) that could be tightened. | 2 / 3 |
Actionability | Provides concrete copy-paste blocks (hook JSON, mkdir commands, `python3 instinct-cli.py promote --dry-run`), but the repeatedly-referenced `observe.sh` is not present in the bundle, so a core executable piece is missing. | 2 / 3 |
Workflow Clarity | The observe→detect→create→evolve sequence is shown in the diagram and promote has a --dry-run checkpoint, but the broader automated learning workflow lacks explicit validation gates despite involving batch/auto operations. | 2 / 3 |
Progressive Disclosure | The body is well-sectioned but monolithic — reference-like content (config tables, file structure, scope guide, version diffs) is all inline with no split into reference files, and the referenced observe.sh is absent from the bundle. | 2 / 3 |
Total | 8 / 12 Passed |