Thanks to visit codestin.com
Credit goes to github.com

Skip to content

appautomaton/presentation

Repository files navigation

Presentation Skills

A business question goes in. A consulting-grade deck comes out.

Four composable agent skills covering the full arc of deck production: the argument, the identity, and the artifact. Built for Claude Code, readable by any agent that understands SKILL.md and AGENTS.md.

skills output pptxgenjs echarts playwright offline agents license

Pipeline

Two producers feed two renderers. Every handoff is a plain file in your working directory, not a framework.

┌──────────────────────┐          ┌──────────────────────┐
│      consultant      │          │     brand-system     │
│  argument architect  │          │  identity designer   │
└──────────┬───────────┘          └──────────┬───────────┘
           │                                 │
           │  storyboard                     │  identity.js
           │  what each slide must prove     │  palette, fonts, style
           │                                 │
           ▼                                 ▼
┌─────────────────────────────────────────────────────────┐
│                     deck production                     │
│                                                         │
│   deck-design-pdf              deck-design-ppt          │
│   pixel-perfect PDF            native editable PPTX     │
│   HTML + Playwright            pptxgenjs                │
└─────────────────────────────────────────────────────────┘

Run the full chain, or point a deck skill at any storyboard and identity you already have. Every skill also works standalone.

The skills

Skill Consumes Produces Core discipline
consultant a business question, your data storyboard (markdown) Hypothesis-driven decomposition. McKinsey, BCG, or Bain methodology. Forcing-function quality gates.
brand-system brand context, or a blank slate brand-brief.md, identity.js, preview PDF Research-first palettes. Typography pairing. Style vocabulary that downstream skills interpret.
deck-design-pdf brief or storyboard, plus identity pixel-perfect PDF Ghost-deck argument gates. 46 self-contained exhibit patterns. Fill-first layout.
deck-design-ppt brief or storyboard, plus identity native editable PPTX 21 slide patterns on one grid contract. Slot budgets as the overflow defense.

Install

Clone anywhere you keep skills, then symlink each skill into your agent's skills directory.

git clone <repo-url> ~/skills/presentation
cd ~/skills/presentation

# Claude Code
for s in consultant brand-system deck-design-pdf deck-design-ppt; do
  ln -s "$(pwd)/$s" ~/.claude/skills/$s
done

# Codex
for s in consultant brand-system deck-design-pdf deck-design-ppt; do
  ln -s "$(pwd)/$s" ~/.codex/skills/$s
done

Three skills carry rendering engines with their own dependencies. Install once per skill:

cd brand-system && npm install
cd ../deck-design-pdf && npm install
cd ../deck-design-ppt && npm install

Fonts, icons, and chart libraries are vendored inside each skill. After npm install, builds run with zero network dependency.

Why the decks do not look generated

  • Action titles are full-sentence conclusions, tested by reading them in sequence with every exhibit hidden. If the titles alone fail to persuade, the argument gets fixed before any pixel exists.
  • Every slide must be load-bearing. If removing it leaves the argument intact, it goes.
  • Charts follow firm visual DNA: restrained palettes, direct labels over legends, annotation as interpretation. No chartjunk.
  • PPTX output stays fully editable. Every element is a native PowerPoint object, no image-of-a-slide shortcuts.

Repo map

presentation/
├── AGENTS.md               unified agent guide (CLAUDE.md symlinks to it)
├── consultant/             analysis and storyboarding, no build engine
├── brand-system/           identity engine, renders preview PDFs
├── deck-design-pdf/        HTML-to-PDF engine, 46 exhibit examples, 7 palettes
├── deck-design-ppt/        PPTX engine, 21 patterns, slot budgets
├── docs/                   GitHub Pages landing
├── generate-previews.js    exhibit preview QA bench
└── verify.js               behavior journal, 26 executable checks

For agents and maintainers

Root AGENTS.md is the single maintainer guide: repository rules, cross-skill contracts, per-skill notes. Skill folders contain only their runtime surface. Per-skill backlogs live in TODO.md where present.

node verify.js runs the behavior journal: executable checks that lock current behavior, from doc-link integrity and handoff round trips to two real deck builds. Run it before and after changes. Regenerate exhibit previews with node generate-previews.js after touching examples or vendored chart libraries.

License

MIT

About

Claude Code and Codex SKILLs for consulting-quality decks — strategy storyboarding, brand-system identity, and pixel-perfect PDF or editable PPTX output.

Topics

Resources

Stars

47 stars

Watchers

0 watching

Forks

Releases

No releases published

Packages

 
 
 

Contributors