CtrlK
BlogDocsLog inGet started
Tessl Logo

skill-deck

Generate slide deck presentations from briefs — use when you need slides, pitch decks, or visual summaries

60

Quality

70%

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 ./.claude/skills/skill-deck/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

Content

67%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, actionable pipeline skill with a clear 4-step workflow and an explicit approval gate. Its main weakness is token efficiency: the best-practices and audience sections restate knowledge Claude already has, and the example-workflows section duplicates the pipeline description.

Suggestions

Trim the "Slide Structure Best Practices" and "By Audience Type" sections to only the non-obvious guidance; drop generic presentation advice ("One idea per slide", "Define technical terms") Claude already knows.

Remove or drastically compress the "Example Workflows" section, which restates the pipeline steps already defined above.

Add a post-render verification step in Step 4 (confirm the PPTX exists and specify how to invoke document-skills:pptx) to close the actionability and workflow-clarity gaps.

DimensionReasoningScore

Conciseness

The pipeline instructions are tight, but "Slide Structure Best Practices" and the audience-type sections restate presentation knowledge Claude already has ("One idea per slide", "5-7 bullets max", "Define technical terms", "Use analogies and examples"), and "Example Workflows" largely restates the pipeline steps — fitting the 3 anchor ('mostly efficient but includes some unnecessary explanation'). Not 2, because there is no conceptual padding like explaining what a library is; not 4, because the best-practices and example-workflow sections are a substantial trimmable block.

3 / 5

Actionability

Concrete, executable guidance throughout: copy-paste plugin check (`/plugin list | grep document-skills`) and install message, explicit AskUserQuestion option sets, a markdown outline template, and a concrete example filename — matching the 4 anchor ('mostly executable guidance with minor gaps'). Not 5 because Step 4 says only "Use the `document-skills:pptx` skill" without a concrete invocation example or command.

4 / 5

Workflow Clarity

A clearly sequenced 4-step pipeline with an explicit user-approval checkpoint ("This is the wireframe gate — the user MUST approve the outline structure before PPTX generation") and skip conditions for optional steps, matching the 4 anchor. Not 5 because there is no post-render verification step (e.g., confirming the PPTX file was created and opens) and no error-recovery guidance.

4 / 5

Progressive Disclosure

No bundle files exist (no references/, scripts/, or assets/), and the single SKILL.md is well-sectioned with clear headers, satisfying the 4 anchor ('good structure; most content appropriately placed; minor organization gaps'). Not 5 because at ~170 lines the audience-specific best practices and example workflows are candidates for a one-level-deep reference file that would keep the main file lean.

4 / 5

Total

15

/

20

Passed

Description

73%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 description that clearly states both capability and trigger conditions with natural keywords. Its main weaknesses are the second-person phrasing and a single-action capability statement that undersells the skill's actual pipeline (research, outline approval, PPTX export).

Suggestions

Rewrite in third person and enumerate the concrete actions, e.g.: "Generates slide deck presentations from briefs with optional research, outline approval, and PPTX export. Use when the user requests slides, pitch decks, or a visual summary of a topic."

Add missing natural trigger terms such as "PowerPoint", ".pptx", and "board deck" to broaden keyword coverage.

Move the boundary guidance currently in the 'trigger' field (e.g., not for markdown-to-PPTX conversion) into the description to reduce overlap risk with presentation-editing skills.

DimensionReasoningScore

Specificity

"Generate slide deck presentations from briefs" names the domain and one concrete action, matching the 3 anchor rather than 4 (no mention of research, outline approval, or PPTX export). However, the rubric's second-person penalty applies — "use when you need slides" addresses the reader directly rather than using third-person voice ("Generates slide decks... Use when the user requests...") — reducing the score by 1.

2 / 5

Completeness

It explicitly answers both: what ("Generate slide deck presentations from briefs") and when ("use when you need slides, pitch decks, or visual summaries"), paralleling the 5 anchor's structure of capability plus concrete trigger phrases. Not 4, because the 'when' clause already enumerates specific trigger terms rather than a single generic condition.

5 / 5

Trigger Term Quality

"slides, pitch decks, visual summaries" plus "slide deck presentations" give good natural keyword coverage users would actually say, matching the 4 anchor. It falls short of the 5 anchor because common synonyms and file formats are missing ("PowerPoint", ".pptx", "presentation" alone, "board deck").

4 / 5

Distinctiveness Conflict Risk

Deck generation from briefs is a clear niche with distinct triggers, but "slide deck presentations" has minor overlap risk with generic presentation-creation skills (e.g., a document-skills pptx skill), matching the 4 anchor. Not 5 because the description itself doesn't delineate that boundary (the disambiguation lives only in the separate 'trigger' field, not the description).

4 / 5

Total

15

/

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
nyldn/claude-octopus
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.