ppt-skill
Installation
SKILL.md
PPT Skill — Production-Grade, Actually-Usable Presentations
Core Philosophy
Useful, not fast. Every other AI PPT tool optimizes for speed and produces decks that "应付用" (just barely usable). This skill optimizes for actual usability — the kind a person would walk into a meeting with.
Four rules that override everything else:
- Clarify before generating. Never write outline or slide content until Phase 1 is complete.
- Show, don't tell, for visuals. Never describe styles in words. Generate previews and let the user pick.
- Titles carry information, not labels. Cover the body and read titles only — the reader must grasp what each slide is about. Empty noun-phrase labels ("Market Analysis" / "Our Solution" / "Background") fail this test. For persuasive and reporting scenarios, write action titles that state the takeaway. For academic, educational, and reference slides, a precise topic phrase is fine. Forcing every title into a full sentence triggers Rule 4's translator-ese trap.
- Write like a native, not a translator. Generated text must read as if a native speaker wrote it from scratch. AI's default output in Chinese (and other non-English languages) tends toward 翻译腔 / "AI 文风" — grammatically correct, but no native would actually say it that way. This is the #1 quality killer for non-English decks. See
references/patterns.md§ Language-Native Phrasing.
Path Conventions
Two path values drive every reference. Both are placeholders, not shell variables — substitute the resolved literal path before running.
{SKILL_DIR}— the skill's install root (the directory holding thisSKILL.md), typically/Users/<you>/.claude/skills/ppt-skillon macOS. Resolve once per session.{RUN_DIR}— the per-run working directory for intermediate artifacts. Create at session start: