CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

2slides-ppt-generator

AI-powered presentation generation via the 2slides API — create slides from text, match a reference image style, summarize documents into decks, add AI voice narration, and export pages/audio. Use for any "make slides", "create a deck", or "slides from this document" request.

Quality

87%

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

82%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 well-structured orchestration body: token-efficient, dense with non-obvious operational constraints (costs, rate limits, URL expiry), and honest about limitations, with executable detail correctly pushed into the detailed guide. Remaining gaps are the absence of any executable quick-start snippet in the body and two-hop navigation to the sub-reference files.

Suggestions

Add a minimal quick-start snippet in the body (e.g., one generate_slides.py invocation with the required --theme-id flag) so the most common path is executable without loading the full guide.

Briefly name the other bundle files (api-reference.md, pricing.md, mcp-integration.md) in the body with one-line purposes so they are discoverable one hop from the root instead of only via detailed-guide.md.

Summarize the canonical job lifecycle as an explicit numbered loop in the body (generate → poll get_job_status.py every 20–30s → validate job state → download and verify ZIP) to make the validation feedback loop self-contained.

DimensionReasoningScore

Conciseness

The ~34-line body earns its tokens with non-obvious operational facts Claude cannot know — "spends the user's credits (10–210 credits/page depending on mode)", "Download URLs expire in 1 hour", "Rate limits apply (Fast PPT 10/min, Nano Banana 6/min)" — and no space is spent explaining concepts Claude already knows. Lean and efficient matches anchor 5; anchor 4 would require trimmable over-explanation, which is absent.

5 / 5

Actionability

The body contains no executable commands (those live one hop away in the referenced guide), but its directives are concrete and specific: the env var name "SLIDES_2SLIDES_API_KEY", "poll async jobs every 20–30s rather than tight-looping", "set an agreed explicit budget/count before billable generation", "Validate ZIP entries and extraction size before unpacking". This is mostly executable guidance with the runnable layer delegated rather than missing — anchor 4, not 5 since copy-paste-ready commands are absent from the body itself.

4 / 5

Workflow Clarity

The body explicitly delegates sequencing ("Read [the detailed guide](references/detailed-guide.md) before executing this skill") to the guide's Workflow Decision Tree, and validation checkpoints for the billable/batch operations are present — "A request timeout may still leave a paid server job running. Check job/account state before retrying" and ZIP-entry validation before unpacking — so the ≤3 cap for batch skills lacking validation does not apply. Anchor 4 (clear sequence via delegation, most checkpoints present); not 5 because no explicit generate → poll → validate → retry feedback loop is spelled out in the body itself.

4 / 5

Progressive Disclosure

Scored against the actual bundle: the body is a lean overview pointing to a real, clearly signaled file ("It retains the complete procedure and reference material"), and that guide indexes api-reference.md, mcp-integration.md, and pricing.md by topic with scripts referenced per workflow — good structure matching anchor 4. Not anchor 5, because reaching api-reference/mcp-integration/pricing is two hops from the root (SKILL.md → detailed-guide.md → those files) and the body never mentions them or the seven scripts directly, deviating from the one-level-deep ideal.

4 / 5

Total

17

/

20

Passed

Description

88%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: concrete capability list plus an explicit trigger clause with natural user phrases, all in third person without padding. The only gaps are a few common trigger synonyms (PowerPoint, presentation) and mild overlap potential with generic presentation/pptx skills.

DimensionReasoningScore

Specificity

Quotes five concrete actions — "create slides from text", "match a reference image style", "summarize documents into decks", "add AI voice narration", "and export pages/audio" — covering generation, styling, summarization, narration, and export comprehensively. This matches the level-5 anchor (multiple specific concrete actions, comprehensive coverage); level 4 would require minor coverage gaps, which are not present.

5 / 5

Completeness

Both halves are explicit: the 'what' lists concrete capabilities ("create slides from text, match a reference image style, summarize documents into decks, add AI voice narration"), and the 'when' is "Use for any 'make slides', 'create a deck', or 'slides from this document' request". This mirrors the level-5 good example almost exactly; level 4 would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Natural trigger phrases users would actually say are quoted directly: "make slides", "create a deck", "slides from this document". Common variants like "PowerPoint", ".ppt", or "create a presentation" are absent, so coverage is good but not comprehensive — matching anchor 4 rather than anchor 5's synonym/extension completeness, and clearly above anchor 3's 'missing common variations'.

4 / 5

Distinctiveness Conflict Risk

The niche is distinct (presentation generation via the named "2slides API" with 2slides-specific triggers like "slides from this document"), but "make slides"/"create a deck" would also naturally trigger a generic .pptx authoring or PowerPoint-editing skill, creating minor overlap. Mostly distinct with minor overlap risk matches anchor 4; anchor 5 would require triggers with minimal conflict against related skills.

4 / 5

Total

18

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

15

/

16

Passed

Repository

sickn33/agentic-awesome-skills

Path

plugins/agentic-awesome-skills-claude/skills/2slides-ppt-generator/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.