CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pptx-skill

Triggers whenever the user asks to do anything with PowerPoint slides (.pptx): read, summarize, extract, edit, create, or convert. Key insight: PPTX files are visually structured — charts, diagrams, and layouts cannot be reliably captured by text extraction alone. The correct approach for understanding slide content is to render the target slide(s) as PNG images (via PptxInspect render) and pass them to a vision model (CloudImageUnderstand), not to rely solely on text/outline extraction. Use text tools (outline / text / shapes) only as supplementary context. Typical phrasings: "summarize this PPT", "what is this deck about", "what's on slide 3", "describe page 5", "make me a Q4 report deck", "change the title of slide 3". Load this skill whenever the user mentions a .pptx file, deck, slides, or presentation.

72

Quality

90%

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

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.

A strong, highly actionable skill body: executable code for every operation mode, good decision tables, and a thoughtful error-recovery section. The main gaps are the unvalidated destructive XML-patch edit workflow and modest redundancy between the two generation demos.

Suggestions

Add a post-edit validation step to the section 2.3 XML-patch workflow (e.g., PptxInspect text on the target slide, or render slide N to visually confirm the new title) and note writing to a backup/output path instead of overwriting deck.pptx in place.

Merge or trim demo 2.2 — it repeats 2.1's layout/master/addText scaffolding; reducing it to the distinct part (looping a data array into per-slide content) would cut significant tokens.

Consider moving the full worked demos into an examples/ reference file linked from a short 'Write' section, keeping SKILL.md as the overview with key points and pitfalls.

DimensionReasoningScore

Conciseness

The body is dense and operational — tool tables, decision tables, and pitfall comments (LAYOUT_WIDE vs LAYOUT_16x9 coordinate mismatch, CJK fontFace) with no re-teaching of concepts Claude already knows. Falls at 4 rather than 5 because demo 2.2 substantially duplicates 2.1's generation pattern (same addText/master/layout scaffolding) and could be trimmed or merged; not 3 since there is no padding or unnecessary explanation elsewhere.

4 / 5

Actionability

Fully executable, copy-paste-ready code throughout: complete pptxgenjs scripts (masters, KPI shapes, charts, notes), an adm-zip XML patch script, concrete PptxInspect/DocConvert/CloudImageUnderstand invocations with parameters, and a symptom/cause/fix recovery table. Matches the 5 anchor — specific examples cover the common cases (create, generate-from-data, edit, read, convert, visual QA).

5 / 5

Workflow Clarity

Sequencing is clear (numbered Read → Write → Convert sections, a summary→next-step decision table, an error-recovery table, an anti-hallucination checkpoint, and a user-confirm checkpoint for >20-slide batches), which would otherwise merit 4. However the section 2.3 edit workflow destructively overwrites the existing deck.pptx with no backup and no post-edit verification step (e.g., re-inspect or render slide 3 to confirm), so the destructive-operation cap holds it at 3; not 2 because most checkpoints and feedback loops are in fact present.

3 / 5

Progressive Disclosure

No bundle files exist and the body references none, so structure is judged on the inline organization: clear section headers, a tool responsibility table, and well-delimited numbered sections make navigation easy. Scores 4 rather than 5 because ~250 lines are fully inline where the long worked demos (2.1–2.2) could live in an examples reference file, and the under-50-line exception does not apply; not 3 since nothing is buried and the organization is genuinely good.

4 / 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 states concrete capabilities, an explicit load condition, and a rich set of natural trigger phrases with synonyms and the .pptx extension. The embedded rendering-methodology detail (PptxInspect/CloudImageUnderstand) makes it long, but every phrase is concrete rather than fluffy, so no dimension is penalized.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — "read, summarize, extract, edit, create, or convert" — covering the full PPTX task space, plus concrete tool-level guidance ("render the target slide(s) as PNG images (via PptxInspect render)"). Matches the 5 anchor (multiple specific concrete actions, comprehensive coverage); not 4 because no meaningful action category is missing.

5 / 5

Completeness

Explicitly answers both what ("read, summarize, extract, edit, create, or convert") and when ("Load this skill whenever the user mentions a .pptx file, deck, slides, or presentation") with concrete trigger phrases. Matches the 5 anchor; not 4 because the 'when' clause is fully explicit, not merely implied or generic.

5 / 5

Trigger Term Quality

Covers natural terms and synonyms comprehensively — "PowerPoint", ".pptx", "PPT", "deck", "slides", "presentation" — and adds verbatim user phrasings ("summarize this PPT", "what's on slide 3", "make me a Q4 report deck"). Matches the 5 anchor including file extensions; not 4 since common variations are all present.

5 / 5

Distinctiveness Conflict Risk

Clear niche scoped to PowerPoint/.pptx with distinct triggers (deck, slides, presentation, slide-N phrasings); no plausible mis-trigger against PDF, Word, or generic document skills. Matches the 5 anchor (clear niche, minimal conflict risk); not 4 because overlap risk is negligible.

5 / 5

Total

20

/

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.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

itsablabla/openloaf-web

Path

apps/server/src/ai/builtin-skills/pptx/en/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.