Content
86%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 lean, highly actionable rulebook: every section gives concrete commands, exact file paths, or copy-paste templates, and nothing pads token budget. The sequence is checklist-framed with a real validate-and-fix loop for page moves; only the absence of a general verification step for ordinary edits and the slightly long incident list in §7 keep it from full marks.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense, project-specific, and assumes Claude's competence — no generic explanations of Obsidian or markdown. The one spot that could be trimmed is §7's four-bullet catalogue of past misses ('shared/production-deploy.md §3.4 named three builds...', plus three more), which illustrates a rule at noticeably more length than the rule itself needs. Not 3 because everything else is lean and earns its tokens. | 4 / 5 |
Actionability | Fully concrete, executable guidance throughout: exact commands ('bun scripts/check-wikilinks.ts', 'grep -rn "wiki/<old-folder>/<name>" .'), a named skill to invoke ('obsidian:obsidian-markdown'), a folder-to-content mapping table, required frontmatter fields, and a copy-paste-ready measured-figure template with a real command and date format. Not 4 because there are no pseudocode placeholders or missing key details. | 5 / 5 |
Workflow Clarity | Eight numbered sections framed as a checklist ('Follow each step before you finish the edit'), with an explicit validate-and-fix loop for the risky move operation ('bun scripts/check-wikilinks.ts finds the broken wikilinks... Fix both in the same pull request') and behavioral checkpoints ('Re-read the whole sentence or row before you finish'). Not 5 because ordinary (non-move) edits have no explicit verification step — the checkpoints are principles rather than a runable check, leaving minor validation gaps. | 4 / 5 |
Progressive Disclosure | The skill is self-contained (~80 lines) with eight well-named sections and a clear overview sentence; it delegates syntax authority to a clearly signaled one-level-deep reference ('Invoke obsidian:obsidian-markdown... It is the syntax authority for this vault') instead of inlining it, and no content that belongs in a separate file is bundled here. Navigation is trivial via the numbered headings. | 5 / 5 |
Total | 18 / 20 Passed |