# Qcut Slide

> CLI-first slide deck generator for QCut. Analyzes markdown or text content, creates a slide outline, generates per-slide image prompts, renders slide images through its own local fal-backed renderer, and merges the results into PPTX or PDF. Ships with its own local slide references. Use when the user wants a real command-line slide workflow rather than an interactive slash-skill flow.

- Skill: `quriosity-agent/qcut-slide` (Agent Skill, multi-file: 37 files)
- Install (CLI): `npx skillmds@latest add quriosity-agent/qcut-slide`
- Raw SKILL.md: https://api.skillmd.com/api/skills/quriosity-agent/qcut-slide/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Docs & Writing
- Author: quriosity-agent (https://skillmd.com/u/quriosity-agent)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/quriosity-agent/qcut-slide

---


# QCut Slide

CLI-first slide deck generation.

## Usage

```bash
export QCUT_SLIDE_ROOT=".claude/skills/qcut-toolkit/qcut-slide"

npx -y bun "$QCUT_SLIDE_ROOT/scripts/main.ts" article.md
npx -y bun "$QCUT_SLIDE_ROOT/scripts/main.ts" article.md --style blueprint --audience executives --slides 10
npx -y bun "$QCUT_SLIDE_ROOT/scripts/main.ts" article.md --style custom --texture paper --mood warm --typography editorial --density balanced
npx -y bun "$QCUT_SLIDE_ROOT/scripts/main.ts" article.md --outline-only
npx -y bun "$QCUT_SLIDE_ROOT/scripts/main.ts" article.md --prompts-only
npx -y bun "$QCUT_SLIDE_ROOT/scripts/main.ts" slide-deck/my-topic --images-only
npx -y bun "$QCUT_SLIDE_ROOT/scripts/main.ts" slide-deck/my-topic --regenerate 2,5
```

## Options

| Option | Description |
|---|---|
| `--style <name>` | Preset style or `custom` |
| `--texture <name>` | `clean`, `grid`, `organic`, `pixel`, `paper` |
| `--mood <name>` | `professional`, `warm`, `cool`, `vibrant`, `dark`, `neutral` |
| `--typography <name>` | `geometric`, `humanist`, `handwritten`, `editorial`, `technical` |
| `--density <name>` | `minimal`, `balanced`, `dense` |
| `--audience <type>` | `beginners`, `intermediate`, `experts`, `executives`, `general` |
| `--lang <code>` | Output language |
| `--slides <number>` | Target slide count |
| `--outline-only` | Stop after writing outline artifacts |
| `--prompts-only` | Stop after writing prompt files |
| `--images-only` | Render images from an existing deck directory |
| `--regenerate 2,5` | Re-render selected slides from an existing deck directory |
| `--provider <name>` | Currently `fal` only |
| `--model <id>` | Override the fal model |
| `--output-dir <path>` | Write artifacts to a specific directory |
| `--project-id <id>` | Save into QCut project folder |
| `--dry-run` | Skip actual rendering and export work |

## Modes

| Mode | Behavior |
|---|---|
| default | Analyze, build outline, write prompts, try image generation if configured, merge if images exist |
| `--outline-only` | Stop after `outline.md` |
| `--prompts-only` | Stop after prompt files |
| `--images-only` | Read existing `prompts/` and generate images only |
| `--regenerate 2,5` | Regenerate selected slides only |

## Output

Default save location (priority order):

1. `--output-dir <path>` — explicit override
2. `--project-id <id>` — `~/Documents/QCut/Projects/<id>/slide-deck/{slug}/`
3. No flags — `~/Documents/QCut/slide-deck/{slug}/`

```text
slide-deck/{topic-slug}/
├── source-{slug}.{ext}
├── analysis.md
├── outline.md
├── prompts/
├── 01-slide-cover.png
├── 02-slide-*.png
├── {topic-slug}.pptx
└── {topic-slug}.pdf
```

## Notes

- Style and prompt references live locally in `qcut-slide/references/`.
- Image generation uses the local `qcut-slide/scripts/image-gen.ts` renderer.
- If image generation cannot run, the command still produces `analysis.md`, `outline.md`, and prompt files.