Content
81%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, information-dense skill body: hard operational rules, precise naming conventions, a gated workflow with validation and recovery loops, and a genuinely progressive reference structure. Weaknesses are modest — some duplicated policy text, a missing example command for the bundled merge-to-pdf script, and one orphaned bundle file that is invisible from the entry point.
Suggestions
Link references/base-prompt.md from SKILL.md (or from workflow.md) — it is currently unreachable from any navigation path, so its content is effectively lost to discovery.
Consolidate the duplicate no-bitmap-text-patching rules (the "⛔ No bitmap text patching" section and the "Text correction policy" under Page Modification) into one canonical statement to save tokens.
Add a one-line example invocation for scripts/merge-to-pdf.ts (e.g., `${BUN_X} {baseDir}/scripts/merge-to-pdf.ts <args>`) so the only bundled script has copy-paste-ready usage.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense and operational with no explanations of concepts Claude already knows, but there is avoidable duplication: the no-bitmap-text-patching rule appears twice (the "⛔ No bitmap text patching" section and the "Text correction policy" under Page Modification), compression instructions repeat between Step 7.1 and the "--ref failure recovery" rule, and "Changing Preferences" overlaps the EXTEND.md section. This fits anchor 4 (efficient with minor trimmable instances) rather than anchor 5's every-token-earns-its-place. | 4 / 5 |
Actionability | Guidance is largely executable: exact file naming patterns (`prompts/NN-{cover|page}-[slug].md`), copy-paste commands (`sips -s format jpeg -s formatOptions 80 …`, `pngquant --quality=65-80 …`), a precedence-ordered backend resolution procedure, and decision tables for reference usage. Minor gaps keep it below anchor 5: no example invocation for `scripts/merge-to-pdf.ts`, and backend call syntax is deferred to other skills' SKILL.md files. | 4 / 5 |
Workflow Clarity | The workflow checklist sequences nine steps with explicit gates — a blocking EXTEND.md setup step ("⛔ BLOCKING"), a required Step 2 confirmation, conditional review gates — plus validation before batch generation ("Never start the first page batch until all selected page prompt files exist on disk") and feedback loops for error recovery ("Retry failed items once", compress → retry → drop `--ref`). This matches the anchor for clear sequence, explicit validation, feedback loops, and checklists. | 5 / 5 |
Progressive Disclosure | SKILL.md works well as an overview: one-level-deep references organized into themed subdirectories (art-styles/, tones/, layouts/, presets/, config/) with load-on-demand cues ("Load … only for this branch", "Read it before recommending combinations in Step 2"), and every referenced path verified to exist. It falls short of anchor 5 because `references/base-prompt.md` (98 lines) is orphaned — reachable from neither SKILL.md nor any bundle file — a minor organization gap consistent with anchor 4. | 4 / 5 |
Total | 17 / 20 Passed |