Repository avatar
Other Tools
v1.1.0
active

ai-video-preproduction

io.github.thinkalim/ai-video-preproduction

Build treatment decks, scripts, pre-production decks with storyboards and shooting schedules.

Documentation

AI Skills for Video Pre-Production

An open-source set of AI skills for creative directors and producers. They take a video from client brief to shoot day: research and concepts, a treatment deck, a script, a pre-production deck with storyboards, and a shot list with shooting schedule and call sheet.

I built these to run my own productions. Brief in. Concepts, a treatment, a script, a pre-pro deck and a shooting schedule out. Every stage drafts, reviews its own work and fixes it before you see it, then stops for your approval.

Free. MIT licensed. Nothing here calls a paid service.

The five skills

Each skill works on its own. Run them in order and each one's output becomes the next one's input.

StageSkillOutput
Concepts and treatmentbrief-to-treatmentMarket research, 3 to 5 concepts, treatment deck (.pptx)
Scriptvideo-scriptLive action, documentary or animation script (.xlsx)
Animation scriptanimation-scriptMotion-graphic AV script with an AI image prompt per frame (.xlsx)
Pre-productionprepro-deck-builderPre-pro deck with cinematography, design, wardrobe and storyboards (.pptx)
Scheduleshot-list-scheduleShot list, day sheets with live start times, set notes (.xlsx)

See the output

Every file in examples/ was made by these skills from the fictional briefs in each skill's references folder.

Treatment deck Twelve-slide AI-generated video treatment deck in sky blue, showing the brief, audience and goals, market landscape, concept, story arc, and look and sound slides

Pre-production deck AI-generated pre-production deck for a commercial, showing overview, creative approach, cinematography, location, production design and casting slides

Scripts and the shooting schedule are in examples/ as .xlsx files.

Use it

As an MCP server. The mcp-server gives any AI agent that supports MCP the tools to build these files directly: treatment decks, scripts, pre-pro decks, image prompts and schedules, each checked before it comes back. Setup is one block of config.

As skills. Upload any folder in skills/ as a skill. Paste a brief.

Any other AI. Each skill has a PROMPT.md. Paste it into any AI chat, then paste your brief.

Build the files. Python 3, then:

pip install openpyxl python-pptx Pillow
python skills/prepro-deck-builder/scripts/build_deck.py skills/prepro-deck-builder/references/example_spec.json deck.pptx

What it won't do

Invent stats, quotes or names. Fix a client's copy without saying so. Generate real people, logos or trademarked characters. The legal pass flags risk. It is not legal advice.

FAQ

How do I make a pre-production deck with AI? Give the prepro-deck-builder skill a script. It writes the overview, creative approach, cinematography, production design and wardrobe in production language, lays out storyboards three frames to a slide, and builds an editable .pptx that opens in any presentation app.

Can AI generate a shot list and call sheet from a script? Yes. The shot-list-schedule skill breaks each scene into primary and coverage shots, schedules the day with realistic durations, lunch and load out, and flags any shots at risk instead of quietly cutting them. The output is an .xlsx with live start times, so editing one duration reflows the whole day.

Can AI write a video treatment from a client brief? The brief-to-treatment skill researches the brand and what already exists in the category, pitches three to five distinct concepts, and builds a treatment deck for the ones you choose. Every market claim is linked to a source.

Does it replace a creative director or producer? No. It handles the drafting and formatting so the people on the project can spend their time on the decisions. Every stage drafts, reviews its own work, and then stops for a human to approve it before the next one begins.

Which AI tools does it work with? It runs as agent skills in any AI assistant that supports them, and as an MCP server any agent can call. Each skill also ships a PROMPT.md that works in any AI chat, and free Python builders that turn the output into finished files.

About the author

Created by Ali Murtaza. More at thinkali.com.

MIT License. See CHANGELOG for versions.

PYPI
ai-video-preproduction-mcp
Install Command
pip install ai-video-preproduction-mcp