CtrlK
BlogDocsLog inGet started
Tessl Logo

marp-slide

Create professional Marp presentation slides with 7 beautiful themes (default, minimal, colorful, dark, gradient, tech, business). Use when users request slide creation, presentations, or Marp documents. Supports custom themes, image layouts, and "make it look good" requests with automatic quality improvements.

80

1.46x
Quality

75%

Does it follow best practices?

Impact

88%

1.46x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./dist/plugins/marp-slide/skills/marp-slide/SKILL.md

The canonical home for this skill is marp-slide in softaworks/agent-toolkit

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.

The skill body is well-structured and highly actionable with real bundle references and a clear sequenced workflow plus a quality checklist. Its main weakness is redundancy across the Quick Start, Creating Slides Process, Available Themes, and Image Integration sections, which inflates token cost without adding guidance.

Suggestions

Merge 'Quick Start > Create Slides' and 'Creating Slides Process > Basic Workflow' into a single workflow to remove the duplicated steps and theme/template listing.

Move the detailed per-theme color/style descriptions into references/theme-selection.md, keeping only a compact theme→use-case→template mapping inline.

Consolidate the image-syntax guidance into one section (and defer detail to references/image-patterns.md) instead of repeating patterns in Quick Start, Creating Slides Process, and Image Integration.

DimensionReasoningScore

Conciseness

The content is mostly actionable but noticeably redundant: 'Quick Start > Create Slides' and 'Creating Slides Process > Basic Workflow' cover the same steps, the Available Themes list duplicates the template mapping, and Image Integration repeats earlier image guidance — it could be tightened by merging these sections.

3 / 5

Actionability

Provides concrete, executable guidance — exact reference paths, Marp directives (<!-- _class: lead -->), real image syntax (![bg right:40%](image.png)), a fixed output directory (/mnt/user-data/outputs/), and a worked markdown example — with only minor gaps from relying on external template files rather than inline complete examples.

4 / 5

Workflow Clarity

A clear numbered sequence (Quick Start steps 1-6 and the Creating Slides Process 1-7) is paired with an explicit Quality Checklist acting as a verification checkpoint; it lacks a validate→fix→retry feedback loop but the task is non-destructive so this is only a minor gap.

4 / 5

Progressive Disclosure

Well-organized overview with one-level-deep, clearly signaled references (all referenced references/*.md and assets/template-*.md paths exist as real files) and a dedicated References index; the inline per-theme color/style descriptions partly duplicate references/theme-selection.md, a minor organization gap.

4 / 5

Total

15

/

20

Passed

Description

83%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, well-structured description that clearly states both capabilities and explicit use-when triggers, with an enumerated theme list and natural trigger phrases. It is slightly held back by some generic trigger terms and missing common synonyms that would maximize distinctiveness and trigger coverage.

Suggestions

Add common synonyms like 'slides', 'deck', or 'slide deck' to broaden natural trigger coverage.

Tighten distinctiveness by leading with the Marp-specific trigger (e.g., 'Use when users request Marp slides or presentation decks') so generic 'presentations' does not invite overlap with non-Marp tools.

DimensionReasoningScore

Specificity

Names the domain (Marp presentation slides) and several concrete capabilities — 7 enumerated themes, custom themes, image layouts, and automatic quality improvements for 'make it look good' requests; minor coverage gaps keep it just below comprehensive.

4 / 5

Completeness

Explicitly answers both 'what' (create professional Marp slides with 7 themes, custom themes, image layouts, quality improvements) and 'when' ('Use when users request slide creation, presentations, or Marp documents') with concrete trigger phrases.

5 / 5

Trigger Term Quality

Includes natural user phrases ('slide creation', 'presentations', 'Marp documents', 'make it look good') but misses common synonyms like 'slides', 'deck', or generic presentation-tool terms.

4 / 5

Distinctiveness Conflict Risk

The Marp keyword anchors a clear niche with distinct triggers, but the generic 'presentations' / 'slide creation' terms create minor overlap risk with general presentation skills.

4 / 5

Total

17

/

20

Passed

Validation

87%

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

Validation14 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

relative_links

Relative link issues: 5 missing

Warning

referenced_paths_exist

Referenced path issues: 2 missing

Warning

Total

14

/

16

Passed

Repository
softaworks/agent-toolkit
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.