QCut Slide
CLI-first slide deck generation.
Usage
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):
--output-dir <path> — explicit override--project-id <id> — ~/Documents/QCut/Projects/<id>/slide-deck/{slug}/- No flags —
~/Documents/QCut/slide-deck/{slug}/
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.
1---2name: qcut-slide3description: 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.4---56# QCut Slide78CLI-first slide deck generation.910## Usage1112```bash13export QCUT_SLIDE_ROOT=".claude/skills/qcut-toolkit/qcut-slide"1415npx -y bun "$QCUT_SLIDE_ROOT/scripts/main.ts" article.md16npx -y bun "$QCUT_SLIDE_ROOT/scripts/main.ts" article.md --style blueprint --audience executives --slides 1017npx -y bun "$QCUT_SLIDE_ROOT/scripts/main.ts" article.md --style custom --texture paper --mood warm --typography editorial --density balanced18npx -y bun "$QCUT_SLIDE_ROOT/scripts/main.ts" article.md --outline-only19npx -y bun "$QCUT_SLIDE_ROOT/scripts/main.ts" article.md --prompts-only20npx -y bun "$QCUT_SLIDE_ROOT/scripts/main.ts" slide-deck/my-topic --images-only21npx -y bun "$QCUT_SLIDE_ROOT/scripts/main.ts" slide-deck/my-topic --regenerate 2,522```2324## Options2526| Option | Description |27|---|---|28| `--style <name>` | Preset style or `custom` |29| `--texture <name>` | `clean`, `grid`, `organic`, `pixel`, `paper` |30| `--mood <name>` | `professional`, `warm`, `cool`, `vibrant`, `dark`, `neutral` |31| `--typography <name>` | `geometric`, `humanist`, `handwritten`, `editorial`, `technical` |32| `--density <name>` | `minimal`, `balanced`, `dense` |33| `--audience <type>` | `beginners`, `intermediate`, `experts`, `executives`, `general` |34| `--lang <code>` | Output language |35| `--slides <number>` | Target slide count |36| `--outline-only` | Stop after writing outline artifacts |37| `--prompts-only` | Stop after writing prompt files |38| `--images-only` | Render images from an existing deck directory |39| `--regenerate 2,5` | Re-render selected slides from an existing deck directory |40| `--provider <name>` | Currently `fal` only |41| `--model <id>` | Override the fal model |42| `--output-dir <path>` | Write artifacts to a specific directory |43| `--project-id <id>` | Save into QCut project folder |44| `--dry-run` | Skip actual rendering and export work |4546## Modes4748| Mode | Behavior |49|---|---|50| default | Analyze, build outline, write prompts, try image generation if configured, merge if images exist |51| `--outline-only` | Stop after `outline.md` |52| `--prompts-only` | Stop after prompt files |53| `--images-only` | Read existing `prompts/` and generate images only |54| `--regenerate 2,5` | Regenerate selected slides only |5556## Output5758Default save location (priority order):59601. `--output-dir <path>` — explicit override612. `--project-id <id>` — `~/Documents/QCut/Projects/<id>/slide-deck/{slug}/`623. No flags — `~/Documents/QCut/slide-deck/{slug}/`6364```text65slide-deck/{topic-slug}/66├── source-{slug}.{ext}67├── analysis.md68├── outline.md69├── prompts/70├── 01-slide-cover.png71├── 02-slide-*.png72├── {topic-slug}.pptx73└── {topic-slug}.pdf74```7576## Notes7778- Style and prompt references live locally in `qcut-slide/references/`.79- Image generation uses the local `qcut-slide/scripts/image-gen.ts` renderer.80- If image generation cannot run, the command still produces `analysis.md`, `outline.md`, and prompt files.
quriosity-agent