AgentSkillsCN

ppt-artisan

使用Marp将Markdown转换为PowerPoint演示文稿，适用于用户希望快速生成幻灯片、管理主题样式，或将MD文件转换为PPTX/PDF格式的场景。

SKILL.md
--- frontmatter
name: ppt-artisan
description: Create and convert PowerPoint presentations from Markdown using Marp. Use when the user wants to generate slides, manage themes, or convert MD to PPTX/PDF.
status: implemented

PowerPoint Artisan (ppt-artisan)

This skill creates high-impact, boardroom-ready presentations. It goes beyond simple Markdown conversion by integrating with custom brand themes and high-resolution visual assets.

Capabilities

1. Visual-First Presentation Generation

  • •Theme Awareness: Automatically checks knowledge/templates/themes/ for client-specific CSS before falling back to default themes.
  • •High-Impact Layouts: Leverages the theme_design_guide.md to structure information using cards, multi-column grids, and "Lead" slides.
  • •Asset Integration: Mandates the use of absolute paths for images and prefers SVG diagrams (from diagram-renderer) for scalability.

2. Multi-Format Conversion

  • •PPTX: Default format for editable presentations.
  • •PDF/HTML: Formats for quick preview and digital distribution.

Fidelity Modes (Audience-Driven Density)

Adjust the information density based on the target audience:

  1. •Executive Mode (High Summary):
    • •Goal: Rapid decision-making and high-level vision.
    • •Design: "1-Slide-1-Message." Focus on ROI, major milestones, and business risks. Max 10-15 slides.
  2. •Standard Mode (Balanced):
    • •Goal: Operational alignment and project management.
    • •Design: Structured overview with key technical metrics. Good for kick-offs and monthly reviews.
  3. •Deep Dive Mode (Technical Exhaustiveness):
    • •Goal: Implementation, auditing, and knowledge transfer.
    • •Design: "Anti-Summarization." Mandatory tables, code evidence, and granular sub-topic separation. No slide limit (e.g., 40+ slides).

High-Fidelity Authoring Workflow

  1. •Audience Identification: Confirm the density mode before drafting.
  2. •Storyboard Strategy: Define slide count targets per chapter based on the selected mode.
  3. •Synthesis: Combine sections with professional templates.

Best Practices

  • •Topic-Per-Slide (Deep Dive): Instead of brief bullets, provide detailed technical specs. A professional system design should naturally exceed 40 slides.
  • •Visual Evidence: Use two-column layouts to place conceptual diagrams next to technical tables.
  • •High Fidelity: Always use --allow-local-files to ensure assets render.

Knowledge Protocol

  • •This skill adheres to the knowledge/orchestration/knowledge-protocol.md. It automatically integrates Public, Confidential (Company/Client), and Personal knowledge tiers, prioritizing the most specific secrets while ensuring no leaks to public outputs.