Content
63%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.
A thorough, largely executable skill body with strong workflow gating and concrete commands. Its main weaknesses are verbose anecdotal padding and a monolithic single-file structure that would benefit from splitting detailed reference material into bundle files.
Suggestions
Trim the historical-drift and war-story paragraphs (e.g. the 'empty for a week' anecdote) to the operative rule they illustrate.
Move large reference blocks (paper/idea/claim page schemas, the query_pack budget table, the Hook 1-4 integration pseudocode) into files under references/ and link to them, improving progressive disclosure.
Convert the Hook integration blocks from pseudocode into concrete, copy-pasteable command sequences where possible, or explicitly justify the pseudocode form.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient operational guidance (commands, schemas, tables), but interspersed with unnecessary narrative padding such as the historical drift anecdote about the 'prose-only init' and the war story about a user's wiki being 'empty for a week'. | 3 / 5 |
Actionability | Subcommand sections give copy-paste-ready bash with real flags (e.g. ingest_paper --arxiv-id --thesis; add_edge --from --to --type --evidence) and a concrete page schema; the integration Hook blocks are pseudocode-style logic rather than directly executable commands, a minor gap. | 4 / 5 |
Workflow Clarity | Subcommands are clearly sequenced with explicit validation/gating (EXP_NODE_OK gating of edges, warn-and-skip resolution, lint health checks, helper-resolution chain with fix instructions); a couple of feedback loops (lint → fix) are implicit rather than fully spelled out. | 4 / 5 |
Progressive Disclosure | Well-organized into clear sections with clearly signaled external references (shared-references/*.md links), but the ~462-line body is monolithic — detailed reference material like the query_pack budget table, paper page schema, and Hook integration code could live in separate bundle files; no bundle files exist. | 3 / 5 |
Total | 14 / 20 Passed |