Content
82%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 tight, well-structured instruction body: lean role framing, a clearly sequenced 6-step workflow with a fallback search loop and a red-flags self-check list, plus concrete script commands. The gaps are minor but real: an unresolved `<plugin>` path placeholder, an unnamed index-update script, and no verification step after filing an answer back into the wiki.
Suggestions
Resolve or define the `<plugin>` placeholder (e.g., a one-line note mapping it to the llm-wiki plugin root) so the wiki_search.py and append_log.py commands are truly copy-paste ready.
In step 6, name the specific script for updating the index (parallel to the append_log.py invocation) or drop "via script" in favor of concrete inline-edit guidance.
Add a post-file verification checkpoint to the workflow — e.g., confirm the new page appears in index.md and optionally run the wiki lint — to close the feedback loop on the write path.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The ~75-line body is lean and imperative throughout ("Read the index first. Do not grep the entire wiki on every query", "Every claim cites a page. No uncited assertions.") and assumes Claude's competence — no priming of concepts Claude already knows. Not 4: lines like "The wiki has done the hard work" are working guidance about trusting pre-synthesized pages, not trimmable padding. | 5 / 5 |
Actionability | Mostly executable: exact script invocations ("python <plugin>/scripts/wiki_search.py --vault . --query \"<terms>\" --limit 5", the append_log.py command with args), a verbatim offer-to-file blockquote, and named frontmatter fields. Not 5: the `<plugin>` placeholder is never resolved to a concrete path, and "Update wiki/index.md (inline or via script)" leaves the script unnamed. Not 3: the commands given are real and copy-paste ready, not pseudocode. | 4 / 5 |
Workflow Clarity | The 6-step workflow is clearly sequenced, with a fallback search loop (step 4) and a red-flags checklist giving explicit recovery actions ("Answering without reading the index → go back", "Citing only one source for a multi-source question → broaden"). Not 5: there is no validation checkpoint after the write path — nothing confirms the filed page landed in the index or passes lint. The destructive/batch cap at 3 does not apply since the write operations (create page, append log) are additive, not destructive. | 4 / 5 |
Progressive Disclosure | Good structure: the body summarizes the workflow and delegates the full version and page templates to clearly signaled references ("Follow engineering/llm-wiki/skills/llm-wiki/references/query-workflow.md", page-formats.md) one level deep. Not 5: the referenced files live in another skill's bundle (this skill ships no references/, scripts/, or assets/ of its own), so the paths are long, repeated, and unverifiable from this skill's directory — a minor navigation gap. | 4 / 5 |
Total | 17 / 20 Passed |