Content
78%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 an actionable, well-structured schema: concrete templates, exact syntax, and a thoughtful token-cost escalation ladder for vault reads. Its main flaws are an undiscoverable bundle reference file (references/karpathy-pattern.md is orphaned) and a few rationale passages that could be tightened.
Suggestions
Add a clearly signaled pointer to the existing bundle file in the Reference section, e.g. "**Original pattern reference**: See [references/karpathy-pattern.md](references/karpathy-pattern.md) for Karpathy's rationale, tooling, and applications" — currently the file is orphaned and undiscoverable.
Trim rationale-heavy passages to the rule itself: the ❌/✅ tag-spacing example and the Obsidian graph-view naming-rule explanation can each be cut to one line without losing the constraint.
Since the rebuild/restore mode is destructive, add one explicit validation note (e.g. "wiki-rebuild verifies the archive before clearing the vault") or state that wiki-status must confirm the delta before any Rebuild is initiated.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with operational rules Claude would not already know (page templates, provenance syntax, retrieval cost ladder, naming rules) and avoids explaining generic concepts like Obsidian or markdown. Minor over-explanation could be trimmed — e.g., the ❌/✅ tag-spacing dialogue and the multi-sentence graph-view rationale for the naming rule — so it falls just short of the 'every token earns its place' anchor. | 4 / 5 |
Actionability | For an instruction-only skill the guidance is fully concrete and copy-paste ready: complete page and project-overview templates, exact index/log entry formats with parseable field syntax, exact provenance markers (`^[inferred]`, `^[ambiguous]`) with worked examples, specific grep patterns (`Grep -A <n> -B <n> "<term>" <file>`, `Grep "\[\[.*?\]\]"`), a directory tree, and an env-var list. These cover the common cases the skill governs. | 5 / 5 |
Workflow Clarity | The processes the skill itself owns are clearly sequenced: the retrieval-primitives escalation ladder has an explicit rule and cost rationale, the ingest-mode table gives when-to-use guidance routed through "Use wiki-status to see the delta and get a recommendation", and maintenance checkpoints appear ("Rebuild this after every ingest operation", "wiki-lint recomputes them and flags drift"). Validation for the destructive rebuild/restore flow is delegated to wiki-rebuild rather than shown, which is a minor gap keeping it below a 5. | 4 / 5 |
Progressive Disclosure | The body itself is well-sectioned, but the one bundle reference file (references/karpathy-pattern.md, containing the original pattern's rationale, tools, and applications) is never linked or mentioned anywhere in SKILL.md — the 'Reference' section lists only companion skills. This matches the anchor 'references present but not clearly signaled'; a 4 would require the existing reference to be surfaced with a clear pointer. | 3 / 5 |
Total | 16 / 20 Passed |