Content
42%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 reads more like a product announcement than an operational skill: setup steps are executable, but the core functionality (observer agent, /instinct commands, evolution clustering) is described in diagrams and tables rather than implemented or referenced, and no bundle files back the referenced scripts. Trimming the promotional sections and shipping the actual hook/CLI code (or references to it) would address all four dimensions.
Suggestions
Remove or compress the v1/v2 comparison table, the "why hooks" philosophy section, backward-compat narrative, and tagline; keep only operational content to recover token budget.
Ship the referenced implementation — hooks/observe.sh and the Python CLI — in a scripts/ directory, or replace the /instinct-* command table with actual command definitions the user can install.
Add a validation checkpoint after hook setup (e.g., run a tool call and confirm observations.jsonl gains a line) so the workflow has a feedback loop before relying on observation data.
Move the full config.json schema and confidence-scoring rules into a references/ file and link to it one level deep from a leaner SKILL.md.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body carries noticeable padding: a v1-vs-v2 marketing comparison table, a "为什么用钩子而非技能进行观察" philosophy section with a pull quote, backward-compatibility narrative, and a closing tagline — content that explains/promotes rather than instructs and could be cut without losing actionable guidance. | 2 / 5 |
Actionability | The hook JSON configs, mkdir commands, and config.json example are concrete and copy-paste ready, but the four /instinct-* commands and the "Python CLI" are named without any implementation — the referenced hooks/observe.sh and CLI do not exist in the bundle (no references/, scripts/, or assets/ directories are present). | 3 / 5 |
Workflow Clarity | The quick start provides a visible three-step sequence (enable hooks → init directories → use commands), but there are no validation checkpoints (e.g., verify hooks fire or that observations.jsonl is growing), and the later stages depend on commands and a CLI whose mechanics are never shown. | 3 / 5 |
Progressive Disclosure | A single ~295-line file inlines material that belongs in separate references — the full config schema, confidence-scoring philosophy, and v1/v2 history — with no pointers to external files, though section headers do provide basic structure. | 3 / 5 |
Total | 11 / 20 Passed |