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.
The body is highly actionable with excellent validation-gated workflows, but it is over-long for a SKILL.md: redundant render-backend sections and fully-detailed backend variants inflate token cost, and several referenced bundle directories (styles/, examples/, docs/) are not present in the bundle. Tightening redundancy and moving the large style/recipe tables into their referenced files would lift both conciseness and progressive disclosure.
Suggestions
Deduplicate the render-backend precheck: state it once and have the template-clone and editable-mode sections reference it, instead of restating the full platform/install table twice.
Move the 33-row styles table and 6-row recipes table into styles/README.md and examples/ respectively, leaving the SKILL.md body a concise pointer plus the top representative examples.
Ensure the referenced bundle directories (styles/, examples/, docs/) actually ship alongside scripts/, or trim body references to files that exist, so progressive-disclosure navigation resolves to real files.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | At 810 lines the body is mostly efficient operational guidance (no 'what is a PPT' padding), but it is noticeably long with redundancy — the render-backend precheck is restated verbatim in both the template-clone and editable-mode sections, and three backend paths are each explained in full; not 2 because the content is substantive rather than padded, not 4 because the redundancy could clearly be tightened. | 3 / 5 |
Actionability | Fully executable, copy-paste-ready commands throughout — `generate_ppt.py --prepare-only`, `render_template.py --check`, `md_to_plan.py`, `--edit`/`--element-updates` examples, JSON slide_spec blocks, and a pptx packaging snippet — covering the API-direct, Codex-native, codex-backend, template-clone, editable, and external-image cases. | 5 / 5 |
Workflow Clarity | Multi-step processes are explicitly numbered ('生成流程', 'Skill 调用规范', '生成流程（模板克隆）') with explicit validation checkpoints and feedback loops — '在跑任何 --template-pptx 命令之前...先检查', `render_template.py --check`, and per-page review of `editable_renders/page-XX.png` — so the destructive/batch cap does not apply. | 5 / 5 |
Progressive Disclosure | References are well-signaled and one-level-deep ('完整结构...见 docs/workflow.md', 'docs/edit_guide.md', 'styles/README.md'), but scored against the actual bundle only `scripts/` exists while the referenced `styles/`, `examples/`, and `docs/` directories are missing, and the 33-row styles table and 6-row recipe table are inlined rather than split out; not 5 because of the missing bundle dirs and inlined reference-table content, not 3 because the in-body navigation is genuinely clear. | 4 / 5 |
Total | 17 / 20 Passed |