About this skill
Prompting Playbook for Sora 2
Sora 2 rewards prompts that read like a shot on a storyboard and punishes vague ones: "cinematic" without a lens, an action with no timing, a duration requested in prose that the model ignores. This skill gives your agent OpenAI's own Sora 2 prompting guide as a condensed playbook, so it writes new prompts and rewrites weak ones with the settings, camera, beats, light, dialogue and sound spelled out.
How it works. Type /sora-2-prompting-playbook with an idea or a prompt that is not working. The agent first settles what prose cannot change (model, size, clip length, characters), picks a template, writes the shot with one camera move and timed action beats, names light sources and palette anchors, puts dialogue in its own block, and checks the result against a list of common mistakes. For rewrites it shows before, after and what changed. For a shot that keeps failing it proposes one remix change at a time.
What you get. SKILL.md (the condensed playbook and workflow), references/sora2-prompting-guide.md (the full guide converted from the cookbook notebook, with links to the upstream example images) and templates/prompt-templates.md (10 fill-in templates: product hero, talking head, phone UGC, establishing shot, action in beats, two-person dialogue, image-to-video, character cameo, remix edit, two-shot sequence).
Based on the Sora 2 Prompting Guide by OpenAI (MIT): https://github.com/openai/openai-cookbook/blob/main/examples/sora/sora2_prompting_guide.ipynb
What we changed
- Converted the notebook to plain markdown with a script; the guide's text is unchanged, images are linked rather than embedded.
- Wrote a condensed playbook as the skill entry point, organised as a workflow: settings first, then shot, motion, light, characters, audio, remix and sequencing, then a self-check.
- Wrote 10 fill-in templates ourselves.
- Added the before/after rewrite format. Full list in
NOTICE.md.
Checked against
The files follow the Agent Skills SKILL.md format: spec-only frontmatter, name matching the folder, description under 1024 characters. Claude Code, Codex, Cursor, GitHub Copilot and Gemini CLI read this format. We checked the files against the spec on 2026-11-07, checked that every referenced file exists, and checked the clip lengths and extension limits against OpenAI's video generation docs on the same date. We have not recorded a test session in each agent. The example output on this page comes from a real run of the skill in Claude Code (Claude Opus) on 2026-11-07 with the request shown under "You say"; we have not generated that clip in Sora.
How to install
Copy the files/ folder to .agents/skills/sora-2-prompting-playbook/ and to .claude/skills/sora-2-prompting-playbook/ in your project (or unpack the zip there), start a new session and type /sora-2-prompting-playbook followed by your idea or prompt. The SKILL.md and its reference files also work pasted into ChatGPT, Claude or Gemini as a system or project instruction; in ChatGPT, add them to a project's instructions and files and ask for Sora prompts there.
Not affiliated with OpenAI.





