CtrlK
BlogDocsLog inGet started
Tessl Logo

pptx

从论文、大纲或结构化文本生成 PowerPoint (.pptx) 演示文稿。Use when 用户需要把一篇论文/文章/大纲做成幻灯片、slides、演示文稿、PPT、deck。Don't use when 只需纯文本总结、生成 Word/PDF、或修改已有 pptx 的单个像素级样式。

68

Quality

83%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Low

Low-risk findings worth noting

SKILL.md
Quality
Evals
Security

Quality

Content

76%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.

The body is highly actionable with a concrete script-call contract and lean prose, but the generation workflow lacks any validation/verification step and one referenced file (reference.md) does not exist in the bundle.

Suggestions

Add a validation step to the workflow (e.g., after generation, open/inspect the .pptx or run a quick check that slide count is 8-12 and bullets are non-empty) to lift workflow_clarity past the batch-operation cap of 3.

Create the missing references/reference.md (or remove the reference to it) so that all in-body file references resolve to real bundle files.

Tighten slightly verbose phrasing like '一份合格的演示文稿总页数应为 8-12 页' to '总页数 8-12 页' to push conciseness toward 5.

DimensionReasoningScore

Conciseness

The body is lean — a short step list, a JSON schema, and constraints — and does not explain concepts Claude already knows, but a few phrases ('一份合格的演示文稿总页数应为 8-12 页') are mildly padded, keeping it just below the 'every token earns its place' anchor.

4 / 5

Actionability

Provides a concrete, copy-paste-ready tool invocation run_skill_script(...) with a complete JSON payload schema and explicit numeric constraints (≥8 slides, 3-5 bullets), fully covering the common generation case.

5 / 5

Workflow Clarity

The four-step sequence (通读→规划页序→提炼要点→生成文件) is clear, but this batch generation workflow has no validation checkpoint (e.g., verify the produced .pptx opens / bullets fit), so per the batch-operation cap it cannot exceed 3.

3 / 5

Progressive Disclosure

Well-structured overview that defers detail to clearly signaled one-level-deep references (reference.md, scripts/generate_pptx.py); the script exists, but the referenced reference.md has no corresponding references/ directory, a minor organization gap above the 'buried/inline' anchor.

4 / 5

Total

16

/

20

Passed

Description

90%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 description with excellent trigger-term coverage and an explicit Use when / Don't use when boundary that gives clear what-and-when guidance. The only relative weakness is specificity, which states one concrete action rather than enumerating several.

Suggestions

Add 1-2 more concrete actions to the 'what' clause (e.g., '生成 8-12 页演示文稿,提炼论文要点为每页 3-5 条 bullet') to lift specificity from 3 toward 4-5.

Consider adding '.pptx' alongside the existing extension mention and the English term 'presentation' for even broader trigger coverage.

DimensionReasoningScore

Specificity

Names the domain (论文/大纲/结构化文本) and one concrete action ('生成 PowerPoint (.pptx) 演示文稿'), but does not enumerate a broader set of concrete capabilities, matching the '1-2 concrete actions' anchor rather than the comprehensive 4-5.

3 / 5

Completeness

Explicitly states both what it does ('生成 PowerPoint 演示文稿') and when to use it ('Use when 用户需要把一篇论文...做成...PPT'), plus a 'Don't use when' negative boundary, matching the anchor that requires concrete trigger phrases for both.

5 / 5

Trigger Term Quality

Comprehensive natural-term coverage including synonyms (幻灯片, slides, 演示文稿, PPT, deck) and the file extension (.pptx), matching the top anchor.

5 / 5

Distinctiveness Conflict Risk

Clear niche (论文/大纲→PPT) with distinct triggers and an explicit exclusion clause for Word/PDF/纯文本总结, giving minimal conflict risk per the top anchor.

5 / 5

Total

18

/

20

Passed

Validation

100%

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

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
bojieli/ai-agent-book
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.