CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

pptx

Presentation toolkit (.pptx). Create/edit slides, layouts, content, speaker notes, comments, for programmatic presentation creation and modification.

54

Quality

68%

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 ./scientific-skills/document-skills/pptx/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

56%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 core workflows (raw-XML editing, template-based creation, thumbnails) are among the strongest possible: fully sequenced, with explicit validation checkpoints and error-recovery feedback loops. Quality is dragged down by heavy padding (an 18-palette color catalog, design menus, injected promotional/off-skill sections) and by bundle-structure gaps where mandatory referenced files (html2pptx.md, ooxml.md, generate_schematic.py) are absent from the shipped bundle.

Suggestions

Ship the referenced files: either include html2pptx.md and ooxml.md in the bundle or remove/replace the MANDATORY read steps pointing to them; likewise remove or provide scripts/generate_schematic.py.

Move the color-palette catalog and "Visual Details Options" menus into a separate design reference file (e.g. references/design.md) and keep a 3-4 line pointer in SKILL.md, cutting ~90 lines of inlined reference material.

Delete the off-skill sections ("Visual Enhancement with Scientific Schematics" and the K-Dense Web promotion) — they consume tokens, reference resources not in the bundle, and dilute the pptx-focused workflows.

DimensionReasoningScore

Conciseness

The body is noticeably verbose and padded: an 18-entry example color-palette catalog with hex codes, extensive "Visual Details Options" design menus that restate design knowledge Claude already has, an off-skill "Visual Enhancement with Scientific Schematics" section, a promotional "K-Dense Web" section, and heavy ALL-CAPS emphasis repetition ("CRITICAL/IMPORTANT/MANDATORY/NEVER" dozens of times). Not a 1 because the core workflow sections (OOXML editing, template replacement, thumbnails) are dense and largely free of explaining basics — a pptx-is-a-ZIP one-liner is genuinely useful — but the palette catalog and injected sections clearly pad the token budget.

2 / 5

Actionability

Most guidance is executable: exact commands for markitdown, unpack/pack/validate, rearrange.py, inventory.py, replace.py, thumbnail.py, soffice/pdftoppm, plus a full annotated replacement-JSON example and real validation-error outputs. It is not a 5 because two MANDATORY entry-point resources ([html2pptx.md], [ooxml.md]) and scripts/generate_schematic.py are referenced but do not exist in the bundle, so a Claude following the creation/editing workflows literally would immediately hit missing files (only the unpack.py path gets a find fallback).

4 / 5

Workflow Clarity

The editing workflow has an explicit validate-after-each-edit feedback loop ("Validate immediately after each edit and fix any validation errors before proceeding"), the creation workflow has a thumbnail visual-validation loop with named failure modes and "Repeat until all slides are visually correct", and the template workflow is a well-sequenced 7 steps with validation error examples. It falls short of 5 because the two principal workflows (create, edit) each begin with a mandatory read of a file (html2pptx.md, ooxml.md) that is absent from the bundle, and the off-skill schematics section inserts an unrelated sub-workflow into the creation path.

4 / 5

Progressive Disclosure

Scored against the actual bundle: the five scripts in scripts/ (html2pptx.js, inventory.py, rearrange.py, replace.py, thumbnail.py) are real and correctly referenced, but the two documented reference documents (html2pptx.md, ooxml.md) and the scientific-schematics resources do not exist, leaving the SKILL.md pointing at phantom files. Additionally, substantial content that clearly belongs in reference files — the ~90-line design/palette catalog and the detailed inventory-JSON schema documentation — is inlined in the body. Structure and section signaling exist, but the missing references and inlined bulk place this between the "references present but not clearly signaled / content should be separate" anchor and the good-structure anchor.

3 / 5

Total

13

/

20

Passed

Description

70%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 solid, specific description with a clear niche and good natural trigger terms, weakened by the complete absence of a "Use when..." trigger clause and the omission of common phrasings like "PowerPoint" and "deck". It reads as a capability list rather than an invocation guide.

Suggestions

Add an explicit trigger clause, e.g. "Use when the user mentions PowerPoint, .pptx, slides, decks, speaker notes, or presentation files."

Include the terms "PowerPoint" and "deck" as trigger synonyms alongside ".pptx" and "presentation".

Mention analysis/text-extraction of presentations to reflect the reading/analysis workflows the body covers.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "Create/edit slides, layouts, content, speaker notes, comments" — with the domain named via "Presentation toolkit (.pptx)". It falls short of a 5 because analysis/text-extraction workflows covered in the body are not mentioned, and "for programmatic presentation creation and modification" partially restates the earlier actions rather than adding new coverage.

4 / 5

Completeness

The "what" is clear (create/edit slides, layouts, content, speaker notes, comments), but there is no "Use when..." clause or equivalent explicit trigger guidance; "for programmatic presentation creation and modification" only weakly implies when to invoke the skill. Per the judging guidelines, a missing explicit trigger clause caps completeness at 3 — this is not a 4 because the "when" is absent rather than merely imprecise.

3 / 5

Trigger Term Quality

Good natural-term coverage: "Presentation", "slides", "layouts", "speaker notes", "comments", and the ".pptx" file extension are all terms users would naturally say. A few natural terms are missing — most notably "PowerPoint" (the most common user phrasing) and "deck" — which keeps it at the "good coverage, a few natural terms missing" anchor rather than 5.

4 / 5

Distinctiveness Conflict Risk

The .pptx presentation niche is clear and distinct — "slides", "speaker notes", and ".pptx" triggers do not plausibly fire for document, spreadsheet, or code skills. It matches the "clear niche with distinct triggers; minimal conflict risk" anchor; it is not a 4 because there is no meaningful overlap with sibling format skills.

5 / 5

Total

16

/

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

skill_md_line_count

SKILL.md is long (520 lines); consider splitting into references/ and linking

Warning

relative_links

Relative link issues: 2 missing

Warning

referenced_paths_exist

Referenced path issues: 1 missing

Warning

Total

13

/

16

Passed

Repository

googolme/run0204

Path

scientific-skills/document-skills/pptx/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.