Content
88%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.
An exceptionally actionable, well-validated skill body: exact commands, syntax-level XML gotchas, and a workflow with explicit lint/read-back gates and error-recovery loops. Its weaknesses are minor — repeated replace/update routing guidance and one unverifiable cross-skill reference.
Suggestions
Consolidate the +replace-slide vs +update-slide guidance (currently stated in the Quick Reference table, the editing paragraph, the Shortcuts table, and 核心规则 7) into a single authoritative location to reduce token cost.
Fix or verify the ../lark-shared/SKILL.md reference marked CRITICAL at the top of the body — it does not resolve within this bundle.
Consider moving the ~65-line 豆包设计原则 section into its own reference file (linked alongside visual-planning.md) to keep SKILL.md a lean routing hub.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The body is dense with non-obvious operational knowledge (e.g., '文字颜色必须用 color 属性而不是 fontColor', 'lineSpacing="multiple:xx"', '图片必须用 <img> 而不是 <image>', rgba gradient format with stop percentages) and explains nothing Claude already knows. However, the +replace-slide vs +update-slide routing guidance is repeated ~4 times (Quick Reference table, editing paragraph, Shortcuts table, 核心规则 7) and the read-planning-docs mandate appears in three CRITICAL blocks plus 执行前必做 plus Step 1 — minor trimming opportunities, matching anchor 4 rather than 3 since the repetition is deliberate emphasis on error-prone decisions, not padding. | 4 / 5 |
Actionability | Everything is executable: copy-paste commands ('lark-cli wiki +node-get --node-token ... --as user --format json', 'lark-cli auth login --domain slides'), exact attribute syntax with a full gradient example, exact paths (.lark-slides/plan/<deck-or-task-id>/slide_plan.json), a machine-checkable lint gate ('summary.error_count 必须为 0'), and numeric limits (960x540, 20 MB, 10 pages per screenshot batch, 40px margins) covering all common cases. | 5 / 5 |
Workflow Clarity | The four-step 生成流程 has explicit validation gates: mandatory xml_lint.py before submission, post-create read-back via slides +xml-get, verification per workflow/validation-xml.md, and an error-recovery feedback loop per workflow/error-handling.md ('失败或部分成功按 workflow/error-handling.md 处理;局部问题优先用 +replace-slide 修正'). Destructive deletes require read-back confirmation first, satisfying the feedback-loop requirement for destructive/batch operations — matching the top anchor. | 5 / 5 |
Progressive Disclosure | The body acts as a hub with well-signaled, one-level-deep references (references/cli/*, references/workflow/*, references/xml/*, references/planning-layer.md), and all ~20 referenced paths were verified to exist; heavy assets (254 KB XML schema, 747 KB icon index) are correctly kept out of SKILL.md. Two minor gaps keep it below the top anchor: the CRITICAL-mandatory reference ../lark-shared/SKILL.md does not exist in the bundle (unverifiable/missing), and the ~65-line inline 豆包设计原则 design guidance could arguably live in a reference file like the other planning layers. | 4 / 5 |
Total | 18 / 20 Passed |