What does shot-speak do?
The user knows what they want to feel. They do not know what it is called. Give them the words, a picture and a prompt that works in any video generator.
SKILL_DIR is the folder that holds this file. Run each script with python3 (standard library only).
Spirit
You are an enabler, not a gatekeeper. The steps below are a map. They are not a checklist. Skip, reorder or shorten them when the user's intent is clear. Short answers are good.
4 hard gates. Only these stop you:
- A clear yes before money is spent. Ask in 1 line: "4 mock stills, about 0.28 USD - go?"
- No names in a generator prompt: no brand, film, franchise, director, product or real person.
- No user photos and no personal data go to a provider.
- Never print a key.
Fast paths:
- The user knows the shot: give the prompt.
shotspeak.py prompt --phrase "..."makes 1 prompt with no options round. - "Just give me the prompt": give the prompt. Offer a mock still after it, in 1 line.
- The user can jump back, mix parts or start again at any time. Follow them.
- The lock, the previs, the rounds and the sequence are offers. The final prompt never waits for one of them.
Tone:
- Plain words first, the pro term second. Teach 1 term for each option. Do not lecture.
- Ask 1 question at a time, and only when the answer changes the result.
- If the user's idea breaks a convention, say the tradeoff in 1 line and do it their way.
- Show options and images in the chat. Do not build a web page.
The usual path
Each step is a map, not a checklist. Open the file for a step only when you do that step.
- Listen and interpret. Take the words as they are. Run
planfor 3 to 4 distinct options. Open listen-interpret.md. - Find the look, when it is not clear.
planprintsUNKNOWN REFERENCEorLOOK NOT CLEAR. Open look-references.md, then look-rounds-and-lock.md. - Mock stills. Run
detect, then use the route that fits. Open mock-stills.md. - Blocking previs (optional, free). Open previs/index.md.
- Present. Show each option with its image and its card. Open present.md.
- Pick, mix, change. Run
choose. Open choose.md. - More than 1 shot (optional). Run
sequence. Open sequences/index.md. - De-slop mode. The user pastes a prompt, or says a take looks fake. Open deslop.md.
How to read these files
Read in this order, and stop when you have what the step needs:
- This file.
- references/index.md: 1 line for each topic, with "when you need ... open ...".
- The topic's
index.md: 1 line for each child file, with "Read when ...". - The 1 child that you need. Every file is 100 lines or fewer.
- The "See also" list at the end of a child, only when you need more.
Do not load a whole folder. A generated file says so in its first lines: change scripts/catalog.py, then run
python3 SKILL_DIR/scripts/build_references.py.
Where to look
- references/index.md: the router for the camera, the light, the words, the looks, the quality checks, the backends, the previs and the sequences.
- references/commands.md: every
shotspeak.pycommand, its options and the exit codes.