Content
88%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 well-engineered procedural skill: the workflow is unambiguously sequenced with real validation and rollback safeguards around destructive vault writes, and nearly all guidance is executable as written. The main improvement levers are trimming a few over-explanatory sentences and moving the scoring/matching rule tables into a reference file to shorten the single-file body.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is operational throughout — scoring tables, matching rules, executable bash — with only minor trims available (the NFKD parenthetical "decompose accented characters to base + combining marks, strip combining marks" and the "this is your 'vocabulary'" metaphor explain things Claude already knows). Not a 5 because a few sentences restate why a rule exists rather than just giving the rule; not a 3 because there is no padded section or conceptual tutorial. | 4 / 5 |
Actionability | Fully executable guidance: a copy-paste-ready git snapshot script with failure handling, concrete scoring tables ("Exact name match in text | +4"), confidence-threshold actions ("≥ 6 EXTRACTED — Apply inline"), before/after markdown examples, exact YAML blocks for relationships/affinity, and a locked `obsidian-wiki memory sync` command with enumerated fields. Specific examples cover the common cases. | 5 / 5 |
Workflow Clarity | Seven clearly sequenced steps with explicit validation checkpoints and error-recovery loops for a write-heavy batch operation: a pre-write git snapshot that aborts the skill on failure ("stop before editing the vault; never continue without the promised snapshot"), confidence labels that gate which candidates are applied, rollback instructions, and QMD failure handling ("do not roll back the vault changes; report the QMD status separately"). This satisfies the destructive/batch-operation feedback-loop requirement that would otherwise cap the score at 3. | 5 / 5 |
Progressive Disclosure | No bundle files exist (references/, scripts/, assets/ are absent), so this is a single-file skill; it is well-organized with clear step headers and its external pointers (llm-wiki/SKILL.md sections, `.skills/llm-wiki/references/MEMORY.md`, WRITING.md) are explicitly named and one level deep. Not a 5 because the self-contained ~300-line body inlines material (the scoring rubric table, matching rules, QMD refresh procedure) that a bundle could have split out, keeping the top-level file longer than an overview needs to be; not a 3 because nothing is buried or nested and the inline placement is defensible for a procedural workflow. | 4 / 5 |
Total | 18 / 20 Passed |