Content
77%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.
An highly actionable, well-validated workflow with executable commands and explicit error-recovery checkpoints throughout. Its weaknesses are redundancy and harness boilerplate that inflate token cost, a monolithic inline config-save script, and references to styles/ and test files that are missing from the actual bundle.
Suggestions
Remove the duplicated title/intro (one of "# Markdown to PDF" vs "# MD to PDF") and trim the Codex-collaboration/approval meta-paragraph to only what affects this skill's execution.
Move the ~35-line inline config-save shell/Python block into a bundled script (e.g. scripts/save_config.py) and invoke it with arguments, keeping SKILL.md a lean overview.
Fix or remove references to missing bundle files: either include `styles/default.json` and `test/test-all-elements.md` in the bundle or drop the STYLES/TEST instructions that depend on them.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The operational core (Steps 0-4, mode tables, commands) is dense and efficient, but there is real padding: two duplicate title sections ("# Markdown to PDF" and "# MD to PDF") with near-identical intros, a long meta-paragraph about Codex collaboration/approval semantics that is harness boilerplate rather than task content, and a ~35-line inline shell/Python config-save block. This fits 'mostly efficient but includes some unnecessary explanation or could be tightened'; it is not a 2 because none of it explains concepts Claude already knows. | 3 / 5 |
Actionability | Every step ships copy-paste-ready, fully executable commands with explicit placeholder substitution rules ("replace NEW_JSON; keep every other byte"), exact config JSON shape, literal help text to print, concrete mode-resolution tables, and exact output-parsing instructions (STATUS/OUTPUT/PAGES/SIZE/ENGINE lines). This matches the top anchor: fully executable commands covering the common cases. | 5 / 5 |
Workflow Clarity | Steps 0-4 are clearly sequenced with explicit validation checkpoints after every execution ("STOP if ❌", "STOP if INSTALL_FAILED", "STOP if CONVERT_FAILED") and a concrete feedback loop ("read error output, attempt fix, retry once"). Mode routing, gates, and the Step 4 report format are all explicit, matching the anchor for clear sequence with explicit validation and error-recovery loops. | 5 / 5 |
Progressive Disclosure | Structure exists (numbered steps, per-mode sections) and the two real bundle scripts are clearly referenced via <skill-directory> paths, but the inline config-save Python block is content that belongs in a bundled script, the body references files absent from the bundle ("choose a bundled style from `styles/`", "`styles/default.json`", "`test/test-all-elements.md`" do not exist), and there are duplicate top-level sections. This fits 'some structure but could be better organized' better than the well-split 4 anchor; it is above a 2 because the scripts references that do exist are clearly signaled and central content is not buried. | 3 / 5 |
Total | 16 / 20 Passed |