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.
A strong, highly actionable skill body: every rule is backed by exact commands, numbers, or tables, and the workflows include genuine validation checkpoints and error-recovery loops. Its weaknesses are a monolithic structure that inlines a large design-system reference instead of splitting it out, and verbose spots in the model-discovery section that could be trimmed.
Suggestions
Move the color palette table, font pairings, and layout/camera pattern catalogs into a references/design.md (or similar) and keep only the selection rules inline, so the SKILL.md stays a lean overview with well-signaled one-level-deep references.
Tighten the Model Discovery Flow — the Step 6 website catalog with filter walkthroughs and the scripted user-dialogue templates can be condensed to the link plus license note, saving substantial tokens.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with skill-specific operational knowledge (officecli commands, property tables, curl recipes) and avoids explaining concepts Claude already knows, but at ~550 lines several sections could be tightened — the Step 6 website catalog with filter walkthroughs and the scripted user-dialogue templates in the Model Discovery Flow pad the file. Not a 4 because the trimming opportunities are more than minor. | 3 / 5 |
Actionability | Guidance is fully executable throughout: copy-paste-ready `officecli add ... --type 3dmodel` commands with exact props, working Sketchfab/Khronos curl commands, a runnable Python build loop, and concrete numeric ranges (area ratio >= 1.5x, roty deltas 30-90°). The common cases are covered with specific, complete commands. | 5 / 5 |
Workflow Clarity | The multi-step flows are clearly sequenced with explicit validation checkpoints and feedback loops: a compatibility gate before generation, post-download verification (file exists, .glb, <50MB), per-slide coordinate verification via `officecli get --depth 1`, and a Phase 4 checklist (one model3d per slide, same name prop, area-ratio rule, no repeated patterns). Error recovery paths are given for install failures and Sketchfab login walls. | 5 / 5 |
Progressive Disclosure | The body is well-sectioned with headers, but it is a single monolithic ~550-line file with no bundle files (no references/, scripts/, assets/); the design-system material (10 color palettes, 8 font pairings, layout patterns, camera language) is inline where it clearly belongs in a separate reference file. It is above 2 because section structure and navigation within the file are good, and the one external pointer (`../morph-ppt/reference/styles/INDEX.md`) is clearly signaled. | 3 / 5 |
Total | 16 / 20 Passed |