mdpr-skill

Overview

Use this skill as the optional agent companion for MDPR, a deterministic Markdown-to-presentation runtime. MDPR owns parsing, layout, theming, validation, and final PPTX/HTML/PDF rendering. This skill helps an agent review MDPR workflows, propose weak semantic hints, and explain visual findings without taking control of slide geometry.

The upstream skill source is ch040602/mdpr-skill, which includes schemas, review commands, compatibility artifacts, visual evidence examples, and MDPR boundary documentation.

When to Use This Skill

• Use when the user asks about MDPR, mdpresent, Markdown-to-PPTX, or Markdown presentation review.
• Use when generated MDPR artifacts need semantic, narrative, accessibility, or visual review notes.
• Use when the user wants Codex-style presentation workflow hints while keeping MDPR as the deterministic renderer.
• Use when comparing MDPR output against image-only deck generators such as a codex-ppt style workflow.
• Use when a reusable theme or style-pack proposal should be expressed as an approval-bound MDPR candidate instead of direct final slide edits.

Core Boundary

• Let MDPR own parsing, slide splitting, recipes, layout, coordinates, geometry, typography, colors, z-order, arrows, effects, exact icon assets, renderer object IDs, and final PPTX objects.
• Keep agent output semantic, evidence-based, and schema-valid.
• Express fixes as Markdown cleanup, MDPR rulebook changes, config changes, deterministic policy changes, or approval-bound proposals.
• Preserve the ability to build the same deck with all agent hints disabled.
• Do not mutate source Markdown unless the user explicitly asks for a cleaned source draft.

How It Works

Step 1: Identify the MDPR Surface

Classify the user's request before producing advice:

• semantic hints: compact intent, grouping, importance, and icon-keyword suggestions.
• review report: visual or narrative concerns grounded in rendered evidence, manifests, or validation reports.
• layout intent: high-level layout goals from a summarized template catalog, never concrete placeholder coordinates.
• theme candidate: reusable token and style-pack proposal for later MDPR approval/import gates.
• codex-ppt compatibility: feature mapping and comparison notes only; do not turn MDPR into a full-slide image renderer.

Step 2: Ground Every Finding

Reference available evidence such as:

• source Markdown path or heading text
• MDPR manifest summaries
• rendered preview image paths
• validation report IDs
• source notes or citation metadata
• schema names such as agent-hint.json, review-report.json, or mdpr-theme-candidate-v1

If evidence is missing, say what artifact is needed instead of inventing a pass/fail result.

Step 3: Keep Hints Weak

Allowed hints:

• slide or section intent
• content grouping
• relative importance
• icon-search keywords
• accessibility or citation review notes
• generated-image candidate briefs when an icon would be too small or too semantically ambiguous

Disallowed hints:

• final coordinates, sizes, z-order, geometry, or object IDs
• exact colors, typography, arrows, effects, or icon asset choices
• final layout IDs or placeholder IDs
• pass/fail validation decisions not backed by MDPR validation

Step 4: Route Fixes to MDPR-Owned Changes

When repeated issues appear, recommend a deterministic follow-up surface:

• Markdown cleanup
• MDPR rulebook change
• MDPR config/profile change
• MDPR theme-pack registration
• MDPR validation improvement
• approval-bound deck-local override or style-pack candidate

Useful Local Commands

Run these only when the upstream mdpr-skill CLI is available in the current workspace and the referenced input files exist.

node bin/mdpr-skill.js hint --source-sha256 <64hex> --out .mdpresent/proposals/agent-hint.json
node bin/mdpr-skill.js review --manifest dist/mdpresent-manifest.json --out .mdpresent/review/review-report.json
node bin/mdpr-skill.js narrative --markdown deck.md --manifest dist/mdpresent-manifest.json --out .mdpresent/review/narrative-review.json
node bin/mdpr-skill.js layout-intent --layout-catalog template-layout-catalog.json --out .mdpresent/review/layout-intent.json

…