CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

ppt-generator

产品经理、运营专员及综合办公文员在准备商业演示、学术汇报或培训课件时,通过七角色协作工作流,自动分析主题、推荐模板、填充内容并智能配图,一键输出高质量 PPTX 文件,将数小时的排版制作缩短至几分钟!

Quality

76%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/ppt-generator/ppt-generator/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

63%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A well-structured multi-mode workflow skill with genuinely excellent progressive disclosure (annotated resource index, real one-level-deep bundle files) and mostly executable guidance. Its main liability is token waste: seven generic persona-positioning paragraphs and a duplicated modes section inflate the body without adding instructional value.

Suggestions

Delete the seven "角色定位" persona paragraphs (or compress each to one line of role scope); they restate generic assistant qualities Claude already embodies and consume roughly 40 lines.

Remove the duplicated entries in "可选分支" that re-describe 快速大纲模式 and 内容填充模式 already covered by their own sections, keeping only the three genuinely new branches (仅文本优化、仅配图建议、快速生成).

Add a validation loop to 角色七: after running generate_pptx.py, instruct how to verify the output (e.g. re-open and spot-check slide count/layout) and what to do on failure (fix the JSON against ppt_structure_guide.md's 验证规则 and re-run).

DimensionReasoningScore

Conciseness

All seven roles carry multi-line "角色定位" persona paragraphs of pure fluff (e.g. "我是一个可靠、高效、专业的助手,随时为用户提供帮助") that add no instruction value, and the "可选分支" section duplicates the 快速模式 and 内容填充模式 flows already described above. The numbered step lists themselves are tight, which keeps this above a 1, but the padding is substantial rather than incidental.

2 / 5

Actionability

Gives a copy-paste-ready command (`python scripts/generate_pptx.py --input ./ppt_data.json --output ./presentation.pptx`) matching the script's actual CLI, plus concrete constraints (titles ≤20 chars, 3-5 points/page, 10-20 pages, 3-5 chapters) and an explicit image-annotation format (`[图片:xxx]`). Minor gaps: no inline JSON snippet and no guidance for handling script failures, so not a 5.

4 / 5

Workflow Clarity

The seven roles are clearly sequenced with numbered steps, five distinct entry modes are defined, and user-confirmation checkpoints exist ("输出初步大纲供用户确认", "在关键节点(如大纲确认)征求反馈") along with a final "确认文件生成成功" step. However there is no validate-and-retry loop around file generation (e.g. what to do if the script errors), which keeps it below a 5; the operation is generative, not destructive/batch, so the cap-at-3 rule does not apply.

4 / 5

Progressive Disclosure

The 资源索引 section signals every bundle file with both purpose and an explicit when-to-read condition ("格式规范…何时读取:角色二、三、七准备数据时必须参考"), all referenced paths exist in the bundle (verified: two reference guides, the script, and assets/ppt_templates/), and references are one level deep with the JSON spec, visual guide, and templates correctly split out of the overview.

5 / 5

Total

15

/

20

Passed

Description

78%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong, third-person description that names concrete capabilities, the output format, and scenario-based trigger conditions with minimal conflict risk. Its main weaknesses are incomplete capability coverage (the optimize-existing-PPT mode is missing) and a few missing natural synonyms.

Suggestions

Add the optimization capability to the description (e.g. 优化现有 PPT 内容、文本润色), since it is a full workflow mode in the body but invisible in the description.

Include common user phrasings such as 幻灯片/演示文稿/做课件 to broaden trigger matching beyond PPT/PPTX/演示/汇报/课件.

DimensionReasoningScore

Specificity

Lists several concrete actions — "自动分析主题、推荐模板、填充内容并智能配图,一键输出高质量 PPTX 文件" — with the output format explicit. Coverage has gaps: the body's optimize-existing-PPT capability (优化现有 PPT, 文本润色) is absent, and terms like "高质量"/"智能" are marketing filler, so it sits below the comprehensive-coverage anchor.

4 / 5

Completeness

The 'what' is clear (analyze, recommend, fill, illustrate, output PPTX) and a 'when' is present ("在准备商业演示、学术汇报或培训课件时"), which qualifies as explicit scenario-based trigger guidance so the cap-at-3 rule does not bind. The 'when' is anchored to job personas rather than user requests, and omits the optimization scenario, so it does not reach the fully explicit anchor 5.

4 / 5

Trigger Term Quality

Good natural keyword coverage — PPT, PPTX 文件, 商业演示, 学术汇报, 培训课件, 排版 — but misses common synonyms users would say such as 幻灯片, 演示文稿, or 做课件, placing it at 'good coverage; a few natural terms missing' rather than comprehensive.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear PPT/PPTX-generation niche with distinct triggers (PPT, PPTX, 演示, 汇报, 课件) that would not naturally fire a document- or spreadsheet-oriented skill; conflict risk is minimal.

5 / 5

Total

17

/

20

Passed

Validation

93%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

anbeime/skill

Path

skills/ppt-generator/ppt-generator/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.