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-organized with a clear quickstart, concrete hook configuration, and useful tables, but it is a monolithic single file that inlines reference material, contains a corrupted json code block (prose where the plugin-install hook config should be), and offers no validation step to confirm the observation pipeline is actually working. Fixing the broken code block, adding a post-setup verification step, and moving the config reference and confidence tables into reference files would raise most dimensions.
Suggestions
Fix the broken ```json block in the 'プラグインとしてインストールした場合' section — it currently contains Japanese prose where the actual (or 'no configuration needed') instruction/hook config should be, making that install path unexecutable.
Add a validation checkpoint to the quickstart, e.g. 'run any tool call, then confirm ~/.claude/homunculus/observations.jsonl has grown / run /instinct-status to verify observation is live', since editing settings.json hooks is a risky silent-failure configuration change.
Move the full config.json reference, confidence-scoring tables, and the ASCII pipeline diagram into a references/ file (e.g. ARCHITECTURE.md) and trim the v1/v2 marketing table and quote section to reclaim token budget.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The core instructions are domain-specific and lean, but the v1/v2 comparison table, the promotional quote section ('スキルは...約50-80%の確率で発火します' / 'フックは100%の確率で...発火します'), the closing tagline, and inline version-sensitive text ('Claude Code v2.1+') are padding that could be trimmed. Matches anchor 3; not 4 because several sections over-explain, not 2 because the operational content is genuinely efficient. | 3 / 5 |
Actionability | Concrete executable guidance exists (the manual-install hooks JSON block, 'mkdir -p ~/.claude/homunculus/...' commands, the /instinct-* command table), but the 'プラグインとしてインストールした場合' branch places Japanese prose inside a ```json fence instead of actual configuration, and referenced artifacts (hooks/observe.sh, hooks/hooks.json, the Python CLI) are not present in the skill bundle. Matches anchor 3; not 4 because a broken executable block and missing files prevent copy-paste success, not 2 because most guidance is specific and executable. | 3 / 5 |
Workflow Clarity | The quickstart is a clear numbered 1-2-3 sequence (enable hooks, initialize directories, use commands), but there is no validation checkpoint anywhere — nothing to confirm hooks actually fire or that observations.jsonl is being written after the risky settings.json edit. Matches anchor 3; not 4 because checkpoints are absent rather than merely minor, not 2 because the sequence itself is well-ordered and complete. | 3 / 5 |
Progressive Disclosure | Section headers are consistent and navigation within the single file is easy, but this is a ~260-line monolith that inlines the full config.json reference, confidence-scoring tables, and a large ASCII pipeline diagram — content that belongs in separate reference files — and the body points to hooks/ and CLI paths that do not exist in the bundle. Matches anchor 3; not 4 because substantial reference material is inline with no external split, not 2 because the internal structure is real and clearly signaled. | 3 / 5 |
Total | 12 / 20 Passed |