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.
89
88%
Does it follow best practices?
Impact
88%
1.46xAverage score across 3 eval scenarios
Passed
No known issues
Quality
Discovery
92%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong description that clearly communicates capabilities and includes explicit trigger guidance. It lists specific themes and features, uses natural language users would employ, and follows the 'Use when...' pattern. The main weakness is potential overlap with other presentation-related skills, as it doesn't clarify when Marp should be chosen over alternatives like PowerPoint.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Lists multiple concrete actions: 'Create professional Marp presentation slides', '7 beautiful themes', 'custom themes, image layouts', and 'automatic quality improvements'. Names specific themes (default, minimal, colorful, dark, gradient, tech, business). | 3 / 3 |
Completeness | Clearly answers both what ('Create professional Marp presentation slides with themes, custom themes, image layouts, quality improvements') and when ('Use when users request slide creation, presentations, or Marp documents'). | 3 / 3 |
Trigger Term Quality | Includes natural keywords users would say: 'slide creation', 'presentations', 'Marp documents', 'make it look good'. Covers both technical (Marp) and casual user language. | 3 / 3 |
Distinctiveness Conflict Risk | While 'Marp' is distinctive, terms like 'presentations' and 'slide creation' could overlap with other presentation skills (e.g., PowerPoint). The description doesn't clearly distinguish when to use Marp vs other presentation tools. | 2 / 3 |
Total | 11 / 12 Passed |
Implementation
85%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a well-structured skill with strong actionability and excellent progressive disclosure. The workflow is clear with a helpful quality checklist. The main weakness is some redundancy in theme descriptions and workflow explanations that could be tightened to improve token efficiency.
Suggestions
Consolidate theme information - the 'Available Themes' section duplicates information from 'Quick Start' theme selection; consider keeping only the quick selection rules and pointing to a reference file for detailed theme descriptions
Remove the 'Creating Slides Process > Basic Workflow' section as it largely duplicates 'Quick Start > Step 2' - or merge them into a single authoritative workflow
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The skill contains some redundancy - theme descriptions are listed twice (in 'Available Themes' section and again referenced in 'Quick Start'), and the workflow steps overlap with content elsewhere. However, it avoids explaining basic concepts Claude knows and stays focused on Marp-specific guidance. | 2 / 3 |
Actionability | Provides concrete, executable guidance with specific file paths, exact syntax examples (like ``), specific character counts for titles (5-7 chars), and copy-paste ready patterns. The workflow steps are specific and actionable. | 3 / 3 |
Workflow Clarity | Clear numbered workflow with explicit steps: understand requirements → select theme → apply template → structure content → refine → add images → output. Includes a quality checklist at the end for validation. The process is well-sequenced for a non-destructive creative task. | 3 / 3 |
Progressive Disclosure | Excellent structure with quick start overview, detailed sections for each concern, and clear one-level-deep references to external files (references/*.md, assets/*.md). The References section is well-organized with categories and external links clearly separated. | 3 / 3 |
Total | 11 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
- Repository
- softaworks/agent-toolkit
- Commit
3027f20
- 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.