Short Video Creator

Creates short videos for social media platforms. Analyzes content, adapts to platform specs, generates prompts, and calls tuzi-video-gen backend.

Script Directory

This is a workflow-only skill (no scripts). It delegates video generation to tuzi-video-gen.

VIDEO_GEN_DIR: Resolve from skills/tuzi-video-gen/SKILL.md relative to project root.

Step 0: Load Preferences ⛔ BLOCKING

CRITICAL: This step MUST complete BEFORE any video generation.

0.1 Check API Key

echo "${TUZI_API_KEY:-not_set}"
grep -s TUZI_API_KEY .tuzi-skills/.env "$HOME/.tuzi-skills/.env"

Result	Action
Key found	Continue to Step 0.2
Key NOT found	⛔ Run API key setup (see references/config/first-time-setup.md)

0.2 Check EXTEND.md

test -f .tuzi-skills/tuzi-short-video/EXTEND.md && echo "project"
test -f "$HOME/.tuzi-skills/tuzi-short-video/EXTEND.md" && echo "user"

Result	Action
Found	Load, parse, apply settings
Not found	⛔ Run first-time setup (references/config/first-time-setup.md)

Path	Location
`.tuzi-skills/tuzi-short-video/EXTEND.md`	Project directory
`$HOME/.tuzi-skills/tuzi-short-video/EXTEND.md`	User home

EXTEND.md Supports: Default platform | Default model

Schema: references/config/preferences-schema.md

Step 1: Analyze User Input

Analyze the user's content (text, article, script, topic description):

Identify main topic and key points
Determine content type (tutorial, story, showcase, explainer)
Estimate ideal video length and segment count

Step 2: Confirm Platform and Parameters

Use AskUserQuestion to let user choose target platform (unless specified or saved in EXTEND.md):

header: "Target Platform"
question: "目标发布平台？"
options:
  - label: "小红书"
    description: "9:16 竖屏, 720x1280"
  - label: "抖音"
    description: "9:16 竖屏, 1080x1920"
  - label: "X/Twitter"
    description: "16:9 横屏, 1280x720"
  - label: "视频号"
    description: "9:16/16:9, 1080x1920"

Platform Presets

Platform	Aspect	Size	Duration	Notes
小红书	9:16	720x1280	15-60s	竖屏短视频
抖音	9:16	1080x1920	15-60s	竖屏，高分辨率
X/Twitter	16:9	1280x720	5-140s	横屏为主
视频号	9:16	1080x1920	15-60s	竖屏优先

Platform details: See references/platforms/

Step 3: Generate Video Script

Based on content analysis and platform:

Single Video (content fits one clip)

Write a detailed video generation prompt in English
Include: visual scenes, camera movements, style, mood, lighting
Save prompt to prompts/01-video-prompt.md

Long Video (content needs multiple segments)

Split content into logical segments (opening + body + ending)
Write per-segment prompts with continuity notes
Save to prompts/01-segment-opening.md, 02-segment-main.md, etc.

Workflow details: See references/workflows/

Step 4: Generate Video

Single Video

npx -y bun ${VIDEO_GEN_DIR}/scripts/main.ts \
  --promptfiles <output-dir>/prompts/01-video-prompt.md \
  --video <output-dir>/01-video-<slug>.mp4 \
  --size <platform-size> \
  --seconds <duration>

Long Video

npx -y bun ${VIDEO_GEN_DIR}/scripts/main.ts \
  --video <output-dir>/01-video-<slug>.mp4 \
  --segments <N> \
  --segment-prompts <output-dir>/prompts/01-segment-opening.md <output-dir>/prompts/02-segment-main.md ... \
  --size <platform-size> \
  --seconds <per-segment-seconds>

Step 5: Completion Report

Display:

Output video path
Platform and specs used
Model used
Duration

Output Directory

short-video/{topic-slug}/
├── source-{slug}.md
├── prompts/
│   ├── 01-video-prompt.md          (single video)
│   ├── 01-segment-opening.md       (long video)
│   ├── 02-segment-main.md
│   └── 03-segment-ending.md
├── segments/                        (long video temp, cleaned up)
└── 01-video-{slug}.mp4             (final output)

Extension Support

Custom configurations via EXTEND.md. See Step 0 for paths and supported options.