marp-authoring
Scannednpx machina-cli add skill narumiruna/agent-skills/marp-authoring --openclawFiles (1)
SKILL.md
1.3 KB
Marp Authoring Entry
Overview
Thin entry skill for Marp/Marpit authoring. Core principle: route directly to the authoring references instead of skimming the full slide-creator bundle.
When to Use
- Writing Marp/Marpit slides (syntax, directives, layouts)
- Looking for theme features or authoring best practices
- You already have colors and no SVG diagram work
Quick Reference
| Goal | Read |
|---|---|
| Syntax & directives | references/syntax-guide.md |
| Layout patterns | references/patterns.md |
| Complex layouts | references/advanced-layouts.md |
| Themes | references/themes.md |
| QA checklist | references/best-practices.md |
Example
Prompt: "Need a split layout with a code block." β Read syntax-guide.md, then advanced-layouts.md.
Assets
assets/templates/- Starter Marp templatesassets/examples/- Slide examples and patternsassets/icons/- Common slide icons
Common Mistakes
- Skimming slide-creator overview instead of authoring references
- Opening color or SVG modules for authoring-only tasks
Red Flags
- "I'll just skim everything first"
- "Maybe the SVG rules are part of authoring"
Source
git clone https://github.com/narumiruna/agent-skills/blob/main/skills/marp-authoring/SKILL.mdView on GitHub Overview
A thin entry that routes you straight to Marp/Marpit authoring references (syntax, layouts, themes) for slide writing. It helps you avoid skimming the full bundle and speeds up finding the right guidance.
How This Skill Works
You choose the authoring goal and are directed to the exact reference documents (syntax-guide.md, patterns.md, advanced-layouts.md, themes.md, best-practices.md). This keeps you focused on authoring tasks and away from non-authoring modules.
When to Use It
- Writing Marp/Marpit slides (syntax, directives, layouts)
- Looking for theme features or authoring best practices
- You already have colors and no SVG diagram work
- Need layout patterns for common slide structures
- Want a QA checklist to ensure slide quality
Quick Start
- Step 1: Determine your goal (syntax/directives, layouts, or themes)
- Step 2: Open the matching references (syntax-guide.md, patterns.md, advanced-layouts.md, themes.md, best-practices.md)
- Step 3: Implement using assets/templates and run the QA checklist
Best Practices
- Always read the authoring reference that matches your goal (syntax-guide.md, patterns.md, etc.) before drafting slides
- Use assets/templates and examples from the Assets section to speed up setup
- Consult patterns.md for reliable layout patterns and avoid ad-hoc layouts
- For complex layouts, reference advanced-layouts.md rather than experimenting blindly
- Avoid opening color or SVG modules when your task is purely authoring
Example Use Cases
- Need a split layout with a code block? Read syntax-guide.md, then advanced-layouts.md
- Create a themed deck by checking themes.md and applying the theme features
- Apply a simple layout pattern from patterns.md to a product slide
- Validate slide quality using the QA checklist in best-practices.md
- Start from a starter template in assets/templates to accelerate slide creation
Frequently Asked Questions
Add this skill to your agents