# Claude skill

> Install the Live Deck skill so Claude writes, imports and validates presentation decks from your outline, notes or slides exported as images.

The `live-deck` skill teaches Claude to turn an idea, outline, notes or pasted .pptx text into a valid `deck.json`, validate it with the CLI and fix every issue.

```sh
npx skills add AngelSirlopuC/live-deck   # installs skills/live-deck
```

Then ask, from the Live Deck repository root:

```text
Create a live deck about safe passwords, in Spanish, with one quiz.
```

## What the skill does

1. **Plans** one idea per slide, 5–25 slides for a normal talk, and one quiz every 4–8 slides when the audience can answer something.
2. **Directs the art**: picks exactly one [theme preset](https://projects.angelsirlopu.dev/live-deck/docs/themes/) from the topic, audience and venue, and tells you why.
3. **Scaffolds** with `live-deck new <id>` and replaces the template slides, using proven [layout recipes](https://projects.angelsirlopu.dev/live-deck/docs/layouts/).
4. **Validates** with `live-deck validate <id>` and fixes every printed issue until it prints `OK <title> (<n> slides, <q> quizzes)`.
5. **Hands off** the deck path, the preset and why, the slide and quiz count, and the preview URL.

Deck content (titles, text, notes, quiz questions, alt text) is written in your language.

## Prompts that work

- "Create a live deck about our Q3 launch for the sales team, bright room, 12 slides."
- "Turn these notes into a live deck and add a quiz after each section."
- "Convert this pasted .pptx text into a live deck. Keep my slide titles."
- "Add a secret quiz with a 30-second timer after slide 6."
- "Fix the deck `my-talk`: it fails validation."

## Importing designed slides

Already designed your slides in PowerPoint, Keynote, Google Slides, Canva or Figma? Live Deck keeps your design as images and adds the live layer (join QR, quizzes, chat, reactions, effects).

1. Export one PNG or JPG per slide at 1920×1080 (16:9) into one folder, named so they sort in order (`slide1.png`, `slide2.png`, … sort naturally).
2. Ask Claude to import them, or run the CLI yourself:

   ```sh
   npm run deck -- import ./exported --id my-talk --title "My talk"
   ```

3. Claude looks at every image and writes speaker notes, inserts native quiz slides where they help, and turns slides designed as a question with options into [zone quizzes](https://projects.angelsirlopu.dev/live-deck/docs/quizzes/#zone-quizzes).
4. Open `/preview/<id>` and check that the dashed zone outlines sit on your designed options. The outlines appear only in the preview, never in a live session.

The join QR is overlaid on slide 1 (bottom-right, white tile). To move it, edit the `qr` element's `box` on slide 1, keeping it at least 0.25 wide and roughly square on screen.

## Other agents

The skill targets Claude, but nothing in the format is Claude-specific: the [deck format](https://projects.angelsirlopu.dev/live-deck/docs/deck-format/) is documented and the [CLI](https://projects.angelsirlopu.dev/live-deck/docs/cli/) validates any file, so any agent that can edit files and run a shell can write a deck. See [Agents and MCP](https://projects.angelsirlopu.dev/live-deck/docs/mcp/) for why there is no MCP server today.