007-write-presentation

Creates Marp Markdown slide presentations for existing XDRS decision documents.

1|1|Updated Feb 28, 2026
One-click install
npx skills add https://github.com/flaviostutz/xdrs-core --skill 007-write-presentation-flaviostutz
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: 007-write-presentation
Source: https://github.com/flaviostutz/xdrs-core/tree/main/examples/typed-scope/.xdrs/_core/adrs/principles/skills/007-write-presentation
Command: npx skills add https://github.com/flaviostutz/xdrs-core --skill 007-write-presentation-flaviostutz

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Turning a dense decision record (policy, research, article, or initiative) into a clear slide deck is time-consuming and often produces inconsistent results. This Skill guides the creation of Marp Markdown presentations that follow XDRS presentation standards, stay linked to their parent document, and are placed correctly in the repository structure. ## Core Features & Use Cases - Standards-compliant slides: Enforces the XDRS presentation standards (_core-adr-policy-009), including Marp frontmatter, slide limits (under 30 slides), and file naming rules (lowercase, max 64 characters). - Audience-aware planning: Helps define the presentation objective and target audience (executives, engineers, specialists, control) and supports separate slide sets per audience. - Bidirectional linking: Automatically updates the parent document with a link to the slides and requires a references slide linking back, keeping documents and presentations in sync. - Use Case: After finalizing an ADR on naming conventions, ask for an executive slide deck. The Skill locates the parent policy, plans a context-problem-decision-actions storyline, writes 003-naming-conventions-slides-executive.md in the .assets/ folder, and links it from the policy. ## Quick Start Create a Marp slide presentation for the existing XDRS policy document on naming conventions, targeted at an executive audience.

Frequently Asked Questions about 007-write-presentation

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create a Marp slide presentation from a decision record?▼

Identify the existing parent document (policy, research, article, or initiative), define the objective and target audience, then write a Marp Markdown file with `marp: true` frontmatter and `---` slide separators. Store it in the parent's `.assets/` folder and link it from the parent document.

How do I convert an ADR or policy document into slides?▼

Read the parent document fully, extract key points, and organize slides into a context, problem, decision, and next-steps storyline. Keep the deck under 30 slides, minimize text per slide, and end with a references slide linking back to the parent document.

Can I create slides without an existing parent document?▼

No. Slides cannot be standalone in XDRS; they must support an existing policy, research, article, or initiative. If the content spans multiple documents, create a synthesizing article first and build the slides for that article.

What file naming rules apply to Marp slide decks in XDRS?▼

Take the parent document's file name, append `-slides` (or a context suffix like `-slides-executive`), keep it entirely lowercase, and ensure the full name including `.md` is 64 characters or fewer. Shorten the base name if it exceeds the limit.

What diagram formats are supported in XDRS presentations?▼

Prefer plain Markdown tables and lists first, then ASCII art for simple cases, then Mermaid.js for sequence, state, activity, or entity diagrams. Use draw.io exported as Editable Vector SVG only when Mermaid is insufficient, stored in the sibling `.assets/` folder.