Content
85%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 effective overview: highly actionable commands, explicit sequencing, and a validation-driven QA loop make it strong on actionability and workflow clarity. Its one significant defect is that the three workflow documents it routes nearly everything through (create.md, edit.md, read.md) are absent from the bundle, so progressive disclosure is structurally sound but functionally broken.
Suggestions
Ship the referenced workflow files create.md, edit.md, and read.md (or inline their essential steps into SKILL.md) — the decision matrix and 'Where each detail lives' section currently point readers at documents that do not exist.
Trim editorial framing that adds no actionable signal, e.g. 'not a design tool trying to reinvent typography' and the licensing/standards provenance paragraph in the intro, which could be collapsed to one line.
scripts/transcode.py exists in the bundle but is never mentioned; either document it in the commands section or remove it so the file listing matches the skill's stated surface.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and token-efficient — decision matrix, command block, typography and page-setup tables, all concrete with almost no explanation of concepts Claude already knows. It sits between the level-4 anchor ('efficient; minor instances of over-explanation that could be trimmed') and level 5: a few phrases are editorial padding, e.g. 'Users expect it to look like something a human wrote in Word — not a design tool trying to reinvent typography' and the licensing/ECMA-376 provenance paragraph in the intro, so it is noticeably above the midpoint but not quite 'every token earns its place'. | 4 / 5 |
Actionability | Nearly everything is copy-paste executable: 'uv run scripts/extract_text.py input.docx', a seven-command block, a QA section with runnable checks (python-docx open test, grep for placeholder residue, render_pdf.py, a fake-heading inspection snippet), and concrete one-liners like 'soffice --headless --convert-to docx old.doc'. This matches 'Fully executable; copy-paste ready code or commands; specific examples cover the common cases' and exceeds level 4, which tolerates gaps. | 5 / 5 |
Workflow Clarity | The decision matrix routes each situation to a concrete path, the mixing rule 'read → plan → edit/create → validate' gives an explicit global sequence, and the QA checklist provides validation checkpoints with a feedback loop: four explicit verify commands followed by 'If any of these fail, fix and re-run — don't paper over'. This matches the anchor with explicit validation steps and error-recovery loops, which is exactly what XML/document manipulation skills require. | 5 / 5 |
Progressive Disclosure | The structure is well designed — a decision matrix and a 'Where each detail lives' section signaling one-level-deep references to create.md, edit.md, and read.md — but scored against the actual bundle, none of those three referenced files exist (the directory contains only SKILL.md and scripts/), so the main navigation chain is broken and roughly all detailed guidance is missing. This falls below level 4 ('minor organization gaps' — dangling primary references are more than minor) and fits level 3: some structure, references clearly signaled, but the split is not actually realized, while scripts/ references are real and correctly linked. | 3 / 5 |
Total | 17 / 20 Passed |