Skip to main content
skill CX Codex

present · glebis — Claude Code skill: what it does, how to install

present builds interactive HTML slide decks with synced ElevenLabs voiceovers, dual reading modes, and optional GPT Image 2 illustrations.

MIT 117 installs ★ 414 updated 2026-10-23

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add glebis/claude-skills --skill present -a claude-code
Open on GitHub

What present does

This skill converts Markdown documents, research notes, or raw topic prompts into a standalone index.html file. Viewers can toggle between a classic slide deck with keyboard controls and an article mode styled with EB Garamond typography.

Narration for each slide is rendered via the ElevenLabs API, while slide transition timing relies on ffprobe. When visual assets are requested through the --images flag, the skill calls GPT Image 2 to render draft illustrations in aesthetics such as risograph, editorial, or blueprint.

Generating audio fails without an ELEVENLABS_API_KEY placed in ~/claude-skills/elevenlabs-tts/.env. Pass --no-audio if you want slides without voiceovers.

What it helps with

  • turn Markdown research notes into an interactive HTML presentation
  • sync spoken narration to presentation slides with ElevenLabs
  • render thematic illustrations using GPT Image 2
  • provide both a slide deck and an article-style reading layout

Example prompts for the agent

  • /present "AI adoption research" --slides 12 --voice daniel --images risograph
  • /present path/to/research.md --detail detailed --voice alice
  • /present "Project summary" --slides 6 --no-audio

How to install present

1Skills CLI (Vercel)

npx skills add glebis/claude-skills --skill present -a claude-code

2Manually: put the files in place

~/.claude/skills/present/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/present/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about present

How to install present in Claude Code?

Run npx skills add glebis/claude-skills --skill present -a claude-code. The file will be placed in ~/.claude/skills/present/SKILL.md.

What does present do?

It creates a self-contained HTML presentation package from your notes or prompts. The result includes synced audio playback, navigation controls, and an alternate scrollable article layout.

What dependencies are needed for voiceovers and images?

Audio requires ffprobe on your system and an ELEVENLABS_API_KEY set in ~/claude-skills/elevenlabs-tts/.env. Image generation depends on the gpt-image-2 helper script.

Source text

SKILL.md · MIT
---
name: present
description: Generate interactive HTML presentations with professional ElevenLabs voiceover narration synced to slides. Supports dual article/slides mode, scroll-reveal animations, GPT Image 2 illustrations, and configurable detail levels. Use this skill when the user wants to create a presentation, slide deck, narrated briefing, research report with voiceover, or any content that should be presentable as both a readable article and a navigable slide deck. Also triggers on "make a presentation", "create slides", "present this", "narrated deck", "voiceover slides", "briefing with audio", or requests to turn research/notes into a shareable presentation. Works with any content — research findings, meeting summaries, proposals, educational material.
---

# Present — Narrated Interactive Presentations

Generate a self-contained HTML presentation with dual article/slides mode, ElevenLabs narration, optional GPT Image 2 illustrations, and scroll-reveal animations.

## What This Skill Produces

A single `index.html` file (plus audio and optional image assets) that can be:
- Opened locally in a browser
- Deployed to Vercel, Netlify, or any static host
- Shared as a folder

The output has two modes the viewer can toggle between:
1. **Article mode** — long-form scrollable report with Tufte-inspired typography
2. **Slides mode** — navigable presentation with keyboard/click navigation and narrated audio playback

## Quick Start

```
/present "AI adoption research for Arseny" --slides 12 --voice daniel --images risograph
```

Or with a file:
```
/present path/to/research.md --detail detailed --voice alice
```

## Parameters

| Parameter | Values | Default | Description |
|-----------|--------|---------|-------------|
| `--slides` | 5-20 | 12 | Number of slides |
| `--detail` | `executive`, `standard`, `detailed` | `standard` | Content depth |
| `--voice` | ElevenLabs voice name | `daniel` | Narrator voice |
| `--images` | style name or `none` | `none` | Image generation style |
| `--image-prompt` | custom string | auto | Override image prompt prefix |
| `--output` | path | `./presentation/` | Output directory |
| `--deploy` | vercel project or `none` | `none` | Auto-deploy target |
| `--title` | string | auto | Presentation title |
| `--no-audio` | flag | false | Skip audio generation |

### Detail Levels

- **`executive`** (5-7 slides): Key findings only. One stat slide, one recommendation slide, sources. Best for busy stakeholders who need the bottom line.
- **`standard`** (10-14 slides): Full narrative arc. Problem, evidence, analysis, recommendations, sources. The default for most presentations.
- **`detailed`** (15-20 slides): Deep dive. Includes methodology, multiple evidence sections, case studies, detailed recommendations with implementation steps.

### Voice Options

Uses ElevenLabs API. The key must be available in `~/claude-skills/elevenlabs-tts/.env` as `ELEVENLABS_API_KEY`.

Recommended voices for presentations:
- **daniel** — Steady Broadcaster, British, formal (default)
- **alice** — Clear Educator, British, professional
- **matilda** — Knowledgeable, American, upbeat
- **brian** — Deep Resonant, American, comforting
- **george** — Warm Storyteller, British, mature

### Image Styles

When `--images` is set, the skill generates illustrations for key slides using GPT Image 2 (`~/.claude/skills/gpt-image-2/scripts/gpt_image_2.py`). Available styles:

- `risograph` — Gerd Arntz isotype style, muted colors, sand texture
- `editorial` — Magazine photography style, dramatic lighting
- `blueprint` — Technical drawing aesthetic, white on blue
- `ink` — Black ink illustration, hand-drawn feel
- `constellation` — Data visualization aesthetic, dots and lines
- Custom: pass `--image-prompt "your style description"` to override

Images are generated in `--draft` mode first (~$0.006/image). The skill decides which slides benefit from illustration (typically 3-5 out of 12).

## Workflow

### Step 1: Content Analysis

Read the input content (a topic description, a markdown file, vault notes, meeting transcript, or research). Identify:
- The core argument or narrative
- Key data points and statistics
- Natural section breaks
- Quotable findings with sources

### Step 2: Slide Planning

Based on `--detail` and `--slides`, create a slide plan. Each slide needs:

```
Slide N: [Type] — [Title]
Content: [what appears on screen]
Narration: [what the voice says — always more than what's on screen]
Read time: [seconds for an average reader to absorb the visual content]
Image: [yes/no, with prompt if yes]
```

Slide types: `title`, `summary`, `stat`, `evidence`, `comparison`, `quote`, `framework`, `recommendation`, `case-study`, `sources`

The narration script should be conversational and add context beyond what's displayed. It should NOT just read the slide text aloud — it should explain, connect, and elaborate. Target 15-30 seconds of narration per slide.

### Step 3: Generate Audio

For each slide, generate narration using ElevenLabs:

```bash
python3 ~/.claude/skills/elevenlabs-tts/scripts/elevenlabs_tts.py \
  --voice <voice_name> \
  --text "<narration>" \
  --output <output_dir>/audio/slide-<N>.mp3
```

Or use the direct API via the script at `scripts/generate_audio.py` in this skill.

Also generate a transition sound (Rhodes chord) for slide-to-slide transitions.

After generation, get durations with ffprobe to calculate slide timing.

### Step 4: Generate Images (if enabled)

For slides that benefit from illustration, generate images using GPT Image 2:

```bash
python3 ~/.claude/skills/gpt-image-2/scripts/gpt_image_2.py --draft --size 1536x1024 \
  "<style prefix> <slide-specific prompt>" \
  <output_dir>/images/<name>.png
```

Typically generate 3-5 images for a 12-slide deck. Choose slides where a visual metaphor strengthens the point — stat slides, concept slides, and the title slide are good candidates. Don't illustrate every slide.

### Step 5: Build HTML

Use the template at `assets/template.html` as the base. The template includes:

- **Typography**: EB Garamond (body) + DM Sans (labels/numbers)
- **Color palette**: Configurable via CSS variables in `:root`
- **Article mode**: Tufte-inspired layout with executive summary box, stat cards, two-column sections, data tables
- **Slides mode**: Full-viewport slides with fade transitions, keyboard navigation (arrows, space), dot indicators
- **Audio engine**: Single reusable `<audio>` element, slide-synced playback with progress bar, transition sounds between slides
- **Auto-hide controls**: Top bar (mode switcher + audio) appears when cursor enters top 20% of viewport. Bottom nav appears in bottom 20%. Shift+. toggles always-show/always-hide/zone mode.
- **Scroll-reveal animations**: Intersection Observer-based fade-up for sections, staggered stat cards, animated counters, h2 rule-draw effect
- **`prefers-reduced-motion`**: All animations disabled when user prefers reduced motion

Populate the template by replacing placeholder sections with the actual slide and article content.

### Step 6: Test

Open in browser using `/real-browser` or `open <path>`. Verify:
- [ ] Article mode renders correctly, images load
- [ ] Slides mode: all slides navigable, text fits within viewport
- [ ] Audio plays when play button is clicked
- [ ] Audio syncs to slide advancement (each slide waits for narration + read time)
- [ ] Transition sounds play between slides
- [ ] Auto-hide works for top and bottom bars
- [ ] Keyboard navigation (arrows, space) works in slide mode

### Step 7: Deploy (if requested)

If `--deploy` is set, copy output to the target project's `public/` folder and deploy:

```bash
cp -r <output_dir>/* <project_path>/public/<slug>/
cd <project_path> && vercel deploy --prod --yes
```

## HTML Architecture

### Audio Sync Model

Each slide has three timing properties:
- `data-audio="slide-name"` — maps to audio file
- `data-read-time="N"` — seconds for reading the visual content

The audio engine calculates: `slide_duration = max(audio_duration, read_time) + 2s`. After narration ends, it waits for any remaining read time plus a 2-second buffer, plays a transition sound (1.8s), then advances to the next slide.

### Avoiding AI-Looking Formatting

The following patterns read as AI-generated and should be avoided:
- Colored left-bar + bold heading + description blocks (finding cards)
- Large italic pull quotes with colored left border
- Uniform card grids with icon + heading + description
- Gradient text on metrics

Instead use:
- Natural prose paragraphs with inline emphasis
- Definition lists (`<dl>`) for structured points
- Tables for comparisons
- Direct statements woven into flowing text

### Image Paths

Use absolute paths from the deployment root: `/slug/images/name.png`, not relative paths. Relative paths break when URLs load without trailing slashes.

## Files

- `SKILL.md` — This file
- `scripts/generate_audio.py` — ElevenLabs TTS batch generator
- `assets/template.html` — Base HTML template with all CSS/JS
- `references/slide-types.md` — Detailed slide type specifications and examples

© glebis · MIT · glebis/claude-skills

Similar skills

All skills for Frontend and UI →

present by other authors comes first.

present ghaida present builds decks for design reviews, research readouts and pitches: an interview and an approved story outline first, then the slides. CX Codex +1 1,000installs slides claudekit slides is a Claude Code skill for building strategic HTML presentations with Chart.js and responsive layouts. It handles pitch decks, marketing slides, and data-driven presentations. CX Codex +1 49,800installs hyperframes-media calesthio hyperframes-media generates voiceovers, background tracks, sound effects, and subtitles for HyperFrames projects using scripts/audio.mjs. CX Codex +1 ★ 78,316repo stars sag openclaw sag — a skill that turns text into speech through ElevenLabs right from the terminal. The UX copies macOS say, so the learning curve is close to zero. CX Codex +1 5,200installs threejs-audio-generator majidmanzarpour threejs-audio-generator — a skill that turns ElevenLabs into game audio for Three.js: effects, loops, music and voice lines, written straight into the project. CX Codex +1 3,800installs elevenlabs digitalsamba This Claude Code skill generates voiceovers, sound effects, and music through the ElevenLabs API. It activates for audio work on videos, podcasts, and games, including transcription and voice cloning. CX Codex +1 1,800installs elevenlabs-tts MengTo elevenlabs-tts creates ElevenLabs speech audio from inline text or script files through local voice profiles. Use it for narration, voiceovers, and other generated speech tracks. CX Codex +1 1,700installs

From the same set51

The whole set →
sorted Automates getSorted.de in a live browser to create freelancer invoices, track expenses, and file German tax reports. CX Codex +1 151installs rag-eval rag-eval evaluates RAG pipelines against a gold set using cost-capped sweep experiments. CX Codex +1 150installs wow-digest wow-digest collects newsletter emails and Telegram posts, selects surprising reads, and adds them to a daily note. Useful for a tailored morning reading list. CX Codex +1 145installs tg-responder tg-responder is a Claude Code skill for reviewing and approving Telegram reply drafts and tracking unanswered messages to manage your inbox and keep up with important conversations. CX Codex +1 145installs retrospective retrospective analyzes session logs, extracts corrections and workflow failures, then writes approved lessons directly into memory files, skills, or CLAUDE.md. CX Codex +1 135installs site-diagnosis site-diagnosis runs a pre-consultation questionnaire for AI-built websites and turns the answers into a consultation brief. Use it before a site review when the problems are still unclear. CX Codex +1 116installs ecosystem ecosystem audits your Claude Code environment by checking skill staleness, project git activity, CLAUDE.md drift, and Mac Mini services. CX Codex +1 115installs learning-vault learning-vault builds a structured Markdown study vault for certifications or research topics. Generates atomic concepts, review tasks, and learning maps tailored to your confidence levels. CX Codex +1 108installs

Project sponsors

Companies that keep this analytics open