| name | qcut-slide |
| description | 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. |
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.
