From ai-video-producer
Reference for the AI video production workspace — lifecycle phases, folder layout, naming conventions, and working principles. Loaded by the install-video-workspace command and consulted by other commands when they need to know where things live.
npx claudepluginhub danielrosehill/claude-code-plugins --plugin ai-video-producerThis skill uses the workspace's default tool permissions.
A workspace produced by `/install-video-workspace` follows the conventions below. All other commands in this plugin assume this structure.
Guides Next.js Cache Components and Partial Prerendering (PPR) with cacheComponents enabled. Implements 'use cache', cacheLife(), cacheTag(), revalidateTag(), static/dynamic optimization, and cache debugging.
Guides building MCP servers enabling LLMs to interact with external services via tools. Covers best practices, TypeScript/Node (MCP SDK), Python (FastMCP).
Generates original PNG/PDF visual art via design philosophy manifestos for posters, graphics, and static designs on user request.
A workspace produced by /install-video-workspace follows the conventions below. All other commands in this plugin assume this structure.
| Phase | Folder | Contents |
|---|---|---|
| Brief | brief/ | Creative brief, target spec, model/tool selection, vibe references |
| Characters | characters/ | One markdown file per recurring character/subject — appearance, voice, reference image links |
| Script | scripts/ | drafts/ (working), final/ (locked), storyboards/ (shot-by-shot breakdowns) |
| Source assets | assets/ | Reference images, voice samples, voice-clone source audio, SFX, music, fonts, LUTs, overlays |
| Generation output | generation/ | Raw model output by modality: text-to-image/, image-to-image/, image-to-video/, text-to-video/, voice/, lip-sync/, upscale/. Prompts that produced each artefact go in generation/prompts/ |
| Pipelines | pipelines/ | Per-project copies of pipeline recipes; editable without touching the plugin |
| Clips | clips/ | raw/, selected/, edited/, b-roll/ |
| Timeline | timeline/ | Shot list, edit decision list, sequencing notes |
| Exports | exports/ | Thumbnails, captions, subtitle files (.srt/.vtt) |
| Output | output/ | drafts/ (rough cuts), proofs/ (review copies), final/ (locked deliverable) |
| Logs | logs/ | Per-session production logs, model-call records, cost tracking |
brief/creative-brief.md exists with target runtime, format, aspect ratio, and model selection. If generation starts without a brief, prompt the user to run /onboard.generation/prompts/ with a matching filename stem so a take can be reproduced or iterated.generation/<modality>/ and clips/raw/. Only takes the user explicitly approves get copied into clips/selected/. Never delete raw output without asking — iteration loops back to it.brief/tools-and-models.md for the active selection — don't assume defaults.logs/production-log.md for each non-trivial generation: timestamp, model, cost estimate, output path.NN-shortname-vN.ext — e.g. 03-rooftop-establish-v2.mp4. The NN orders shots, vN tracks iterations.generation/prompts/ — e.g. 03-rooftop-establish-v2.md containing prompt + model + parameters.characters/<name>.md.pipelines/<descriptive-name>.md./install-video-workspace — scaffold this structure into a new directory./onboard — capture the creative brief and tools-and-models selection./define-character — add recurring characters/subjects./draft-script — produce a script draft from the brief./storyboard — break the locked script into a shot list./run-pipeline <name> <shot#> — execute a pipeline for a shot./log-take — record a generated artefact./promote-take — promote a raw take into clips/selected/./assemble — propose an ffmpeg edit plan into output/drafts/./export-final — encode locked draft to spec, write to output/final/.clips/selected/ or output/final/ — version with -v2 suffix instead.brief/tools-and-models.md without asking.generation/ or clips/raw/ — discarded takes often get revisited.