Content
92%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 content is an exemplary operational skill document: a gated 9-step workflow with validation checkpoints and retry loops, concrete commands and file conventions, and a clean overview-to-references split where every referenced bundle file exists. The only weakness is mild redundancy across the confirmation, backup, and batch-size sections.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense but operational — tables carry preset and option data, and per-preset specs are externalized. There is some redundancy: the Confirmation Policy section is restated in Step 2, the backup rule appears three times, and batch size is explained in the Options table, Batch Generation Policy, and Changing Preferences. Anchor 4 ('minor instances that could be trimmed') fits; it is far too lean to be anchor 2-3 territory but not token-perfect for 5. | 4 / 5 |
Actionability | Guidance is fully executable: exact merge commands ("${BUN_X} {baseDir}/scripts/merge-to-pptx.ts <slide-deck-dir>"), concrete file layout with naming patterns ("prompts/NN-slide-{slug}.md"), batch dispatch rules with a default of 4 and a 1-8 clamp, and flags with defaults. Specifics cover the common cases, matching anchor 5. | 5 / 5 |
Workflow Clarity | A 9-step checklist with explicit hard gates ("Step 2: Confirmation ⚠️ REQUIRED", "Do not start Step 3 or later until the user completes Step 2"), validation before batch dispatch ("Confirm every prompts/NN-slide-{slug}.md exists (hard requirement)"), a retry-failed-items-once feedback loop, progress reporting ("Generated X/N"), and a backup rule before overwriting files. Clear sequence with explicit validation and error recovery — anchor 5. | 5 / 5 |
Progressive Disclosure | SKILL.md works as an overview with clearly signaled, one-level-deep references (references/styles/<preset>.md, references/dimensions/*.md, references/confirmation.md, references/analysis-framework.md, references/outline-template.md, references/layouts.md, references/modification-guide.md, references/config/preferences-schema.md), all of which exist on disk as verified. Branch-specific detail (references/codex-imagegen.md) is loaded only for that backend branch. Content is appropriately split and easy to navigate — anchor 5. | 5 / 5 |
Total | 19 / 20 Passed |