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-structured, highly actionable skill body with clear multi-step workflows, strong validation checkpoints for destructive/immutable operations, and a real one-level-deep reference. It is slightly long and keeps several large templates inline that could be factored into references.
Suggestions
Move the large correction-mode YAML template and/or the four body-type templates into a reference file (e.g. references/NOTE-TEMPLATES.md) and link to them, tightening the SKILL.md overview and improving progressive disclosure.
Trim framing prose like "The goal is to extract the substance — the knowledge itself — not a summary of what was said" and reduce repeated trigger-phrase lists between the modes to improve token efficiency.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Mostly efficient and task-relevant with direct instructions and templates rather than padded concept explanations, though the three-mode structure introduces some repetition and a few framing sentences (e.g., "The goal is to extract the substance...") that could be trimmed. | 4 / 5 |
Actionability | Provides copy-paste-ready frontmatter templates, per-type body structures, concrete file-path conventions, kebab-case slug rules, and executable QMD commands (`qmd update`, `qmd embed`, `qmd ls`, `qmd get`) covering the common cases. | 5 / 5 |
Workflow Clarity | Multi-step processes are clearly sequenced (Quick mode steps 1–7, Full mode Steps 1–7) with explicit validation checkpoints — the KEEP/SKIP gate, the correction-mode SHA256 pre/post verification with abort-on-mismatch, and a closing Quality Checklist — plus feedback loops for error recovery. | 5 / 5 |
Progressive Disclosure | Good structure with clearly signaled one-level-deep references ("Read references/RAW-FORMAT.md for the full frontmatter spec" — a real file), but the bulk of content (correction YAML template, four body-type templates) is inlined in SKILL.md and could arguably be split out, leaving minor organization gaps. | 4 / 5 |
Total | 18 / 20 Passed |