Content
71%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, executable skill body: an unambiguous three-command pipeline, explicit refusal gates, clear scope boundaries, and sharp differentiation from sibling converters. The main weaknesses are dangling references — both the citations pointer and all script paths point to files absent from the bundle — and the absence of an executable command for the onboarding check and a post-render verification step.
Suggestions
Ship the referenced files or fix the pointers: 'See references/ for full citations' and the 'markdown-html/skills/md-document/scripts/*.py' paths resolve to nothing in this bundle — either include those files or reference scripts relative to the skill (e.g., 'scripts/markdown_parser.py').
Add an executable command for the onboarding gate, e.g. 'python3 scripts/config_loader.py --check' or equivalent, so the refusal rule in hard rule 2 is directly actionable.
Add a post-render validation step to the pipeline, such as verifying document.html exists and contains the injected interactivity marker, with a fix-and-retry loop if a step fails.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and information-rich — symptom/action table, exact pipeline commands, explicit scope boundaries, and smoke-tested behavior claims — with no explanations of concepts Claude already knows. Minor trimmable material: the 'Canon:' attributions in the forcing-question library and the References section partially duplicate in-body citations. This fits 'efficient; minor instances that could be trimmed' (4) rather than the every-token-earns-its-place level 5. | 4 / 5 |
Actionability | The three-step pipeline is given as full, copy-paste-ready bash commands with flags, plus an all-in-one alternative, and the output artifact naming is specified. Two minor gaps keep it below level 5: hard rule 2 gates rendering on 'config_loader.setup_completed() must return True' but provides no executable command to check it, and design_style variants are described without showing how to select one. | 4 / 5 |
Workflow Clarity | The pipeline is clearly sequenced (numbered steps, one command each) and includes pre-flight validation gates — the <100-line refusal and the onboarding check. It is not a destructive/batch operation, so no cap applies. It falls short of level 5 because there is no explicit post-render validation step (e.g., verifying document.html was produced or spot-checking anchors/TOC) and no error-recovery loop if a step fails. | 4 / 5 |
Progressive Disclosure | Sections are well organized and one level deep, but scored against the actual bundle structure: 'See references/ for full citations' and every pipeline command path ('markdown-html/skills/md-document/scripts/*.py') point to files that do not exist in this bundle — there are no references/, scripts/, or assets/ directories. Navigation fails at the reference step, fitting the 'references present but not reliably usable / could be better organized' level 3 rather than level 4's 'references mostly clear'. | 3 / 5 |
Total | 15 / 20 Passed |