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 highly actionable, validation-rich manual: every command is executable, the workflow is sequenced with mandatory pre-code planning and reject-on-leak delivery gates, and external material is pointed to one level deep. Its main weakness is redundancy — the ghost-accumulation, spatial-variety, and shell-quoting rules are each restated three to five times, inflating the file well past what the content requires — and the inlining of material that its own reference files were created to hold.
Suggestions
Consolidate the ghost-accumulation rule into a single authoritative section (§Ghost Discipline & Actor Lifecycle) and reduce the other ~4 mentions (Mental Model, 'Ghost accumulation is silent', the pitfall table row, M-2) to one-line pointers, e.g. '→ see §Ghost Discipline' — this alone removes roughly 15% of the body.
Deduplicate the spatial-variety rule (≥5cm / ≥15° / ≥30% appears in §Mental Model, §What is Morph?, and §Choreography) into the §Scene-actor spatial rule section and reference it from the other two spots.
Move the §Style library lookup workflow (a 4-step procedure tied to reference/styles/) into reference/styles/INDEX.md or a dedicated reference file, keeping only the pointer and the 'coordinates are known-buggy' warning inline.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body consistently adds only CLI-specific knowledge Claude would not have (auto-prefix quirk, ghost thresholds, grep patterns) and never pads with known concepts — but the same critical rules are repeated verbatim-ish many times: ghost accumulation appears in ~5 places (Mental Model, "Ghost accumulation is silent", the full §Ghost Discipline section, the pitfall table, and M-2), the ≥5cm/≥15° spatial-variety rule in 3 places, and the `$9/mo` single-quoting rule in 3. Fits the 3 anchor ("mostly efficient… could be tightened"); not 2 because nothing explains concepts Claude already knows, and not 4 because the duplication is extensive enough that the ~470-line file could shrink by a third without losing information. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready guidance throughout: four complete recipe blocks with exact `officecli add/set` commands and props, a runnable Python helper-invocation script, the M-4 `raw-set` speed example with readback, jq/grep one-liners, and four complete gate scripts with REJECT criteria. Specific examples cover the common morph cases (single element, coordinated actors, long arc, hybrid fade). | 5 / 5 |
Workflow Clarity | Clear sequence (read pptx v2 → plan the §Morph Pair Planning table BEFORE coding → build via recipes → run gates → deliver) with explicit validation checkpoints and feedback loops for a batch operation: Gates 1–5a inherited, a morph-specific Gate 2 grep addendum, and Gate 5b-morph-1..4 proof loops, capped by "If any Gate prints REJECT, fix and re-run — never deliver with a known-open gate". Matches the 5 anchor (explicit validation, error-recovery loops, checklists). | 5 / 5 |
Progressive Disclosure | References are one level deep, well-signaled, and each is annotated with when to read it (References section plus inline "→ see pptx v2 §X" pointers covering decision-rules.md, pptx-design.md, morph-helpers.py/.sh, styles/INDEX.md). Falls short of 5 because the SKILL.md is a ~470-line full manual rather than an overview — recipes, gate scripts, ghost-discipline detail, and the style-library workflow are all inline where some belong in reference files — and no bundle files are present in this skill directory, so the `reference/` paths cannot be verified to exist. | 4 / 5 |
Total | 17 / 20 Passed |