CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

powerpoint

Create, read, edit .pptx decks with python-pptx.

61

Quality

77%

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/productivity/powerpoint/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

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

This is a strong script-bundle skill body: fully executable commands verified against the bundle, a clear five-step procedure with explicit validation checkpoints and fallbacks, and pitfalls restricted to genuinely non-obvious operational knowledge. The only real defects are command duplication between the 'How to Run' block and the Quick Reference table, and a 'tests/' reference pointing at a directory not present in the bundle.

DimensionReasoningScore

Conciseness

The body is dense and operational — no concept explanations, a command table, and pitfalls limited to non-obvious behaviors like run splitting and rId remapping — matching 'efficient; minor instances of over-explanation that could be trimmed'. It is not 5 because the 'How to Run' bash block and the 'Quick Reference' table duplicate roughly a dozen identical command lines, and the Procedure section repeats some of the same flags a third time.

4 / 5

Actionability

Every operation has a copy-paste-ready command whose flags all verify against the actual scripts (e.g. 'pptx_edit.py deck.pptx --replace-text OLD NEW', '--chart-data spec.json'), with concrete inline JSON spec formats ('{"slide": 0, "chart": 0, "categories": [...], "series": {...}}') and an exact PDF-export command — fully executable guidance covering the common cases.

5 / 5

Workflow Clarity

A five-step Procedure (create, read, edit, template, visual verification) is followed by a dedicated Verification section with numbered checkpoints and feedback loops: 'After any create/edit, run pptx_read.py OUT.pptx --outline and check slide count, texts, tables, notes', render-fallback guidance when tools are missing, and per-pitfall recovery notes ('re-read the deck afterward to confirm'). This matches the top anchor for explicit validation with error recovery on destructive/batch edit operations.

5 / 5

Progressive Disclosure

Structure is good: the body is an overview plus quick reference, heavy detail is correctly deferred one level deep to the bundle scripts (full spec format via 'pptx_create.py --help'), and all five referenced scripts exist with matching flags. It is not 5 because the Verification section references 'python -m pytest tests/ -q' but no tests/ directory exists in the bundle — a dangling reference — and the create-spec/chart-ops field inventories are borderline content that could live in a reference file.

4 / 5

Total

18

/

20

Passed

Description

58%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 concise, concrete, and unambiguous about the domain and library, with a clean create/read/edit action triple. Its main weakness is the complete absence of 'when to use' trigger guidance and of the most natural keywords users would say (PowerPoint, presentation, slides). Adding a 'Use when...' clause with those synonyms would lift both completeness and trigger quality.

Suggestions

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

Include the natural synonyms 'PowerPoint', 'presentation', and 'slides' alongside '.pptx' and 'decks' so the description matches how users actually phrase the request.

Optionally name one or two more capabilities (e.g. render slides to PNG, build decks from brand templates) to round out coverage toward the top specificity anchor.

DimensionReasoningScore

Specificity

"Create, read, edit .pptx decks with python-pptx" names the domain and three concrete lifecycle actions, matching the anchor 'lists several specific actions; minor gaps in coverage' (cf. 'Extracts text from PDF files, fills forms, converts pages to images'). It is not 5 because coverage has gaps (no mention of rendering, templates, or notes), and not 3 because three actions across the full create/read/edit lifecycle exceeds '1-2 concrete actions'.

4 / 5

Completeness

The 'what' is clear (create/read/edit .pptx decks with python-pptx) but there is no 'Use when...' clause or equivalent trigger guidance, which per the judging guidelines caps completeness at 3 ('clear what but when is missing or only weakly implied'). Not 2 because the 'what' half is concrete rather than vague; not 4 because 'when' is entirely absent, not merely under-specified.

3 / 5

Trigger Term Quality

Present terms are ".pptx", "decks", and "python-pptx", but the most natural user phrasings — "PowerPoint", "presentation", "slides" — are all absent, matching 'some relevant keywords but missing common variations or synonyms'. It falls short of 4 ('good keyword coverage; a few natural terms missing') because more than a few high-frequency synonyms are missing, and beats 2 because the .pptx extension and 'decks' are genuinely relevant, not generic.

3 / 5

Distinctiveness Conflict Risk

The explicit ".pptx" format and named library give a clear niche with minimal wrong-skill triggering, matching 'mostly distinct; minor overlap risk with closely related skills'. Not 5 because sibling office-document skills (docx/xlsx/pdf decks) are closely related and the description offers no explicit trigger phrases to sharpen the boundary; not 3 because ".pptx" is far more specific than 'works with document files'.

4 / 5

Total

14

/

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

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

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

Warning

Total

13

/

16

Passed

Repository

NousResearch/hermes-agent

Path

skills/productivity/powerpoint/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.