# Marp Authoring

> Use when you need Marp/Marpit Markdown authoring rules, directives, layouts, or theme guidance and want the minimal reading path for slide writing.

- Skill: `tomevault-io/marp-authoring` (Agent Skill, multi-file: 2 files)
- Install (CLI): `npx skillmds@latest add tomevault-io/marp-authoring`
- Raw SKILL.md: https://api.skillmd.com/api/skills/tomevault-io/marp-authoring/raw
- Safety review: pending (external: skill-scanner PASS, skillspector PASS)
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: tomevault-io (https://skillmd.com/u/tomevault-io)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/tomevault-io/marp-authoring

---


# 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 templates
- `assets/examples/` - Slide examples and patterns
- `assets/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"

---
> Converted and distributed by [TomeVault](https://tomevault.io/claim/narumiruna) — claim your Tome and manage your conversions.
<!-- tomevault:4.0:skill_md:2026-04-13 -->

