qcut-slide

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):

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}/

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.