By 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.tsrenderer. - If image generation cannot run, the command still produces
analysis.md,outline.md, and prompt files.