Skill

sora

by openai

AI Summary

Sora enables Claude Code users to generate, remix, and manage AI videos directly through OpenAI's video API. Developers building products with video content (demos, marketing, UI mocks) benefit from integrated video generation workflows.

Install

# Add to your project root as SKILL.md
curl -o SKILL.md "https://raw.githubusercontent.com/openai/skills/main/skills/.curated/sora/SKILL.md"

Description

Use when the user asks to generate, remix, poll, list, download, or delete Sora videos via OpenAI’s video API using the bundled CLI (`scripts/sora.py`), including requests like “generate AI video,” “Sora,” “video remix,” “download video/thumbnail/spritesheet,” and batch video generation; requires `OPENAI_API_KEY` and Sora API access.

Sora Video Generation Skill

Creates or manages short video clips for the current project (product demos, marketing spots, cinematic shots, UI mocks). Defaults to sora-2 and a structured prompt augmentation workflow, and prefers the bundled CLI for deterministic runs. Note: $sora is a skill tag in prompts, not a shell command.

When to use

• Generate a new video clip from a prompt • Remix an existing video by ID • Poll status, list jobs, or download assets (video/thumbnail/spritesheet) • Batch runs (many prompts or variants)

Decision tree (create vs remix vs status/download vs batch)

• If the user has a video id and wants a change → remix • If the user has a video id and wants status or assets → status/poll/download • If the user needs many prompts/assets → create-batch • If the user asks for two versions with a small change (same shot, different subject/detail) → create the base, then remix for the variation • Otherwise → create (or create-and-poll if they need a ready asset in one step)

Workflow

• Decide intent: create vs remix vs status/download vs batch. • Collect inputs: prompt, model, size, seconds, and any input reference image. • If batch: write a temporary JSONL under tmp/ (one job per line), run once, then delete the JSONL. • Prefer CLI augmentation flags (--use-case, --scene, --camera, etc.) instead of pre-writing a structured prompt. If you already produced a structured prompt file, pass --no-augment to avoid double-wrapping. • Run the bundled CLI (scripts/sora.py) with sensible defaults (see references/cli.md). For long prompts, prefer --prompt-file to avoid shell-escaping issues; pair with --no-augment if the prompt is already structured. • For async jobs, poll until complete (or use create-and-poll). • Download assets (video/thumbnail/spritesheet) and save locally. • Remove intermediate files created during invocation (for example prompt.txt, remix_job.json, temp JSONL). If the sandbox blocks rm, skip cleanup or truncate the files without surfacing an error. • Iterate with a single targeted change per prompt.

Quality Score

B

Good

82/100

Standard Compliance75
Documentation Quality72
Usefulness78
Maintenance Signal100
Community Signal100
Scored Today

GitHub Signals

Stars10.2k
Forks569
Issues104
UpdatedToday
View on GitHub

Trust & Transparency

No License Detected

Review source code before installing

Verified Open Source

Hosted on GitHub — publicly auditable

Actively Maintained

Last commit Today

10.2k stars — Strong Community

569 forks

My Fox Den

Community Rating

Works With

Claude Code