CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pptx

当涉及到 .pptx 文件的任何操作时使用此技能——无论是作为输入、输出还是两者兼有。包括:创建幻灯片、演示文稿或路演材料;读取、解析或提取任何 .pptx 文件中的文本(即使提取的内容将用于其他地方,如邮件或摘要);编辑、修改或更新现有演示文稿;合并或拆分幻灯片文件;处理模板、布局、演讲者备注或批注。当用户提到“演示文稿”、”幻灯片“、”PPT“或引用 .pptx 文件名时触发,无论他们之后打算如何使用内容。如果需要打开、创建或操作 .pptx 文件,就使用此技能。

Quality

89%

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

SKILL.md
Quality
Evals
Security

Quality

Content

77%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 strong, dense skill body with excellent verification discipline (explicit fix-revalidate loop, subagent prompt, placeholder grep) and fully executable read/render commands. Its main defects are the two dangling reference files — the editing and from-scratch creation guides are pointed to but missing from the bundle, leaving the primary workflows without executable detail — and some bulk inline design content that could be externalized or trimmed.

Suggestions

progressive_disclosure: Add the missing editing.md and pptxgenjs.md files to the bundle (e.g., under references/) — or, if they cannot be provided, inline the essential unpack/edit/pack steps so the two primary workflows are self-contained.

actionability: Include the concrete commands for the editing workflow in the body (unpack, the slide-editing step, clean, pack via scripts/office/) so the '解包 → ... → 打包' arrow sequence is executable without leaving SKILL.md.

conciseness: Consolidate the repeated visual-element rules in the '避免' section with the '每张幻灯片' guidance above it, and consider moving the 10-row color palette and font pairing tables to a reference file to cut inline tokens.

DimensionReasoningScore

Conciseness

The body is dense and opinionated rather than padded — it explains nothing Claude already knows, and the tables (color palettes, font pairings, sizes) are non-obvious domain specifics that earn their tokens. However, there are minor instances of over-explanation: repeated exhortations in the '避免' section restate points already made ('不要创建纯文本幻灯片' repeats the '每张幻灯片都需要视觉元素' rule), and the 10-row palette table plus font tables are bulk inline content that could be trimmed or externalized. This fits 'Efficient; minor instances of over-explanation that could be trimmed' rather than the lean anchor 5.

4 / 5

Actionability

Reading, rendering, and verification are fully copy-paste ready: 'python -m markitdown presentation.pptx', 'python scripts/thumbnail.py presentation.pptx', 'python scripts/office/soffice.py --headless --convert-to pdf output.pptx', 'pdftoppm -jpeg -r 150 output.pdf slide', the placeholder grep, and a complete subagent prompt template. The gap keeping it below 5 is that the two primary workflows defer all executable detail — the editing workflow is only a high-level arrow sequence ('解包 → 操作幻灯片 → 编辑内容 → 清理 → 打包') with no commands, and the creation workflow is a bare pointer — and their targets (editing.md / pptxgenjs.md) are absent from the bundle, so the deferred guidance is unreachable. This fits 'Mostly executable guidance; concrete code or commands with minor gaps' rather than the incomplete/pseudocode anchor 3.

4 / 5

Workflow Clarity

The verification loop is exactly the anchor-5 pattern: generate → convert to images → check (with both a content check command and a visual-check subagent prompt) → list problems → fix → '重新验证受影响的幻灯片' → repeat until a full pass finds nothing new, plus the explicit gate '在完成至少一个修复-验证循环之前,不要宣布成功'. Checklists are provided (the 12-item visual-check list, the placeholder grep). Editing/packing validation is also present via scripts/office/validate.py in the bundle, and the workflow for the destructive unpack/edit/pack cycle has clear checkpoints. It is not below 5 because no validation gaps exist in the written workflows.

5 / 5

Progressive Disclosure

Structure and signaling are good — a quick-reference table routes each task to the right guide, references are one level deep, and scripts referenced in the body (thumbnail.py, office/unpack.py, office/soffice.py) all exist in the bundle. However, the two main workflow guides the body links to, [editing.md](editing.md) and [pptxgenjs.md](pptxgenjs.md), do not exist anywhere in the bundle (no references/ directory), so the primary navigation paths are broken. That lands at 'Some structure but could be better organized; references present but not clearly signaled' territory — the organization is better than that anchor, but the dangling references prevent the good-structure (4) or clear-overview (5) anchors, and a large design section sits fully inline.

3 / 5

Total

16

/

20

Passed

Description

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

The description is exemplary: it explicitly states comprehensive capabilities in third-person/neutral voice and provides clear, natural trigger phrases with synonyms and the file extension. The only minor nit is a slight redundancy between the trigger sentence and the closing '如果需要打开、创建或操作 .pptx 文件,就使用此技能', but this does not affect any rubric dimension.

DimensionReasoningScore

Specificity

The description enumerates multiple concrete actions — '创建幻灯片、演示文稿或路旺材料' (create slides/presentations/pitch decks), '读取、解析或提取任何 .pptx 文件中的文本' (read/parse/extract text), '编辑、修改或更新现有演示文稿' (edit/modify/update), '合并或拆分幻灯片文件' (merge/split), plus handling '模板、布局、演讲者备注或批注' (templates, layouts, speaker notes, comments). This matches the anchor 'Lists multiple specific concrete actions; comprehensive coverage' — it is not the level-4 anchor because there are no meaningful gaps in coverage of pptx operations.

5 / 5

Completeness

Both questions are explicitly answered with concrete trigger phrases: what — the enumerated action list above; when — '当用户提到"演示文稿"、"幻灯片"、"PPT"或引用 .pptx 文件名时触发,无论他们之后打算如何使用内容'. This is the anchor-5 pattern (explicit 'what' plus explicit trigger 'when'), not level 4 where the 'when' would be less specific.

5 / 5

Trigger Term Quality

It covers natural user phrasing comprehensively with synonyms and the file extension: '演示文稿' (presentations), '幻灯片' (slides), 'PPT', and '引用 .pptx 文件名' (.pptx file names), plus the derived use case of extracting content for reuse in email or summaries. This matches the anchor-5 example pattern ('PDF files, PDFs, forms, document extraction, .pdf') and exceeds level 4, which only allows 'a few natural terms missing'.

5 / 5

Distinctiveness Conflict Risk

The niche is clearly bounded to .pptx files with distinct triggers (presentation/slide/PPT mentions and .pptx file names), closely mirroring the anchor-5 example 'Extract text and tables from PDF files... Use when working with PDF files or when the user mentions PDFs'. It is not level 4 because there is no meaningful overlap with adjacent skills — the scope deliberately covers all pptx operations in one place rather than sharing them with a sibling skill.

5 / 5

Total

20

/

20

Passed

Validation

81%

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

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_version

'metadata.version' is missing

Warning

relative_links

Relative link issues: 4 missing

Warning

referenced_paths_exist

Referenced path issues: 2 deeper-than-1-level

Warning

Total

13

/

16

Passed

Repository

agentscope-ai/QwenPaw

Path

src/qwenpaw/agents/skills/pptx-zh/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.