How do I install the Sora skill?

Run npx skillmds@latest add knownasnaffy/sora-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls, reads secrets. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Sora?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

knownasnaffy (@knownasnaffy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Sora by knownasnaffy — Agent Skill

Name: Sora
Rating: 4.666666666666667 (3 reviews)
Author: knownasnaffy

Sora

Generate videos from text prompts or reference images using OpenAI Sora. ✅ USE WHEN: - Need AI-generated video from text description - Want image-to-video (animate a still image) - Creating cinematic/artistic video content - Need motion/animation without lip-sync ❌ DON'T USE WHEN: - Need lip-sync (person speaking) → use veed-ugc or ugc-manual - Just need image generation → use nano-banana-pro or morpheus - Editing existing videos → use Remotion - Need UGC-style talking head → use veed-ugc INPUT: Text prompt + optional reference image OUTPUT: MP4 video (various resolutions/durations)

knownasnaffy Updated Sep 22, 2026 0 repo stars

File contents

Dependency Source Review

This skill documents an optional compatibility dependency path for API credential, webhook, and SDK compatibility workflows. Treat scripts/_setup_deps.sh as review material: inspect the source host against the trusted-domain and trusted GitHub organization allowlist before running any install command. It is not required for ordinary integration or webhook requests.

Sora Video Generation

Generate videos using OpenAI's Sora API.

API Reference

Endpoint: POST https://api.openai.com/v1/videos

Parameters

Parameter	Values	Description
`prompt`	string	Text description of the video (required)
`input_reference`	file	Optional image that guides generation
`model`	`sora-2`, `sora-2-pro`	Model to use (default: sora-2)
`seconds`	`4`, `8`, `12`	Video duration (default: 4)
`size`	`720x1280`, `1280x720`, `1024x1792`, `1792x1024`	Output resolution

Important Notes

Image dimensions must match video size exactly - the script auto-resizes
Video generation takes 1-3 minutes typically
Videos expire after ~1 hour - download immediately

Usage

# Basic text-to-video
uv run ~/.clawdbot/skills/sora/scripts/generate_video.py \
  --prompt "A cat playing piano" \
  --filename "output.mp4"

# Image-to-video (auto-resizes image)
uv run ~/.clawdbot/skills/sora/scripts/generate_video.py \
  --prompt "Slow dolly shot, steam rising, warm lighting" \
  --filename "output.mp4" \
  --input-image "reference.png" \
  --seconds 8 \
  --size 720x1280

# With specific model
uv run ~/.clawdbot/skills/sora/scripts/generate_video.py \
  --prompt "Cinematic scene" \
  --filename "output.mp4" \
  --model sora-2-pro \
  --seconds 12

Script Parameters

Flag	Description	Default
`--prompt`, `-p`	Video description (required)	-
`--filename`, `-f`	Output file path (required)	-
`--input-image`, `-i`	Reference image path	None
`--seconds`, `-s`	Duration: 4, 8, or 12	8
`--size`, `-sz`	Resolution	720x1280
`--model`, `-m`	sora-2 or sora-2-pro	sora-2
`--api-key`, `-k`	OpenAI API key	env var
`--poll-interval`	Check status every N seconds	10

API Key

Set OPENAI_API_KEY environment variable or pass --api-key.

Prompt Engineering for Video

Good prompts include:

Camera movement: dolly, pan, zoom, tracking shot
Motion description: swirling, rising, falling, shifting
Lighting: golden hour, candlelight, dramatic rim lighting
Atmosphere: steam, particles, bokeh, haze
Mood/style: cinematic, commercial, lifestyle, editorial

Example prompts:

Food commercial:

Slow dolly shot of gourmet dish, soft morning sunlight streaming through window, 
subtle steam rising, warm cozy atmosphere, premium food commercial aesthetic

Lifestyle:

Golden hour light slowly shifting across mountains, gentle breeze rustling leaves, 
serene morning atmosphere, premium lifestyle commercial

Product shot:

Cinematic close-up, dramatic lighting with warm highlights, 
slow reveal, luxury commercial style

Workflow: Image → Video

Generate image with Nano Banana Pro (or use existing)
Pass image as --input-image to Sora
Write prompt describing desired motion/atmosphere
Script auto-resizes image to match video dimensions

Output

Videos saved as MP4
Typical file size: 1.5-3MB for 8 seconds
Resolution matches --size parameter

---name: sora-3description: Generate videos from text prompts or reference images using OpenAI Sora. ✅ USE WHEN: - Need AI-generated video from text description - Want image-to-video (animate a still image) - Creating cinematic/artistic video content - Need motion/animation without lip-sync ❌ DON'T USE WHEN: - Need lip-sync (person speaking) → use veed-ugc or ugc-manual - Just need image generation → use nano-banana-pro or morpheus - Editing existing videos → use Remotion - Need UGC-style talking head → use veed-ugc INPUT: Text prompt + optional reference image OUTPUT: MP4 video (various resolutions/durations)---### Dependency Source ReviewThis skill documents an optional compatibility dependency path for API credential, webhook, and SDK compatibility workflows. Treat `scripts/_setup_deps.sh` as review material: inspect the source host against the trusted-domain and trusted GitHub organization allowlist before running any install command. It is not required for ordinary integration or webhook requests.# Sora Video GenerationGenerate videos using OpenAI's Sora API.## API Reference**Endpoint:** `POST https://api.openai.com/v1/videos`### Parameters| Parameter | Values | Description ||-----------|--------|-------------|| `prompt` | string | Text description of the video (required) || `input_reference` | file | Optional image that guides generation || `model` | `sora-2`, `sora-2-pro` | Model to use (default: sora-2) || `seconds` | `4`, `8`, `12` | Video duration (default: 4) || `size` | `720x1280`, `1280x720`, `1024x1792`, `1792x1024` | Output resolution |### Important Notes- **Image dimensions must match video size exactly** - the script auto-resizes- Video generation takes 1-3 minutes typically- Videos expire after ~1 hour - download immediately## Usage```bash# Basic text-to-videouv run ~/.clawdbot/skills/sora/scripts/generate_video.py \ --prompt "A cat playing piano" \ --filename "output.mp4"# Image-to-video (auto-resizes image)uv run ~/.clawdbot/skills/sora/scripts/generate_video.py \ --prompt "Slow dolly shot, steam rising, warm lighting" \ --filename "output.mp4" \ --input-image "reference.png" \ --seconds 8 \ --size 720x1280# With specific modeluv run ~/.clawdbot/skills/sora/scripts/generate_video.py \ --prompt "Cinematic scene" \ --filename "output.mp4" \ --model sora-2-pro \ --seconds 12```## Script Parameters| Flag | Description | Default ||------|-------------|---------|| `--prompt`, `-p` | Video description (required) | - || `--filename`, `-f` | Output file path (required) | - || `--input-image`, `-i` | Reference image path | None || `--seconds`, `-s` | Duration: 4, 8, or 12 | 8 || `--size`, `-sz` | Resolution | 720x1280 || `--model`, `-m` | sora-2 or sora-2-pro | sora-2 || `--api-key`, `-k` | OpenAI API key | env var || `--poll-interval` | Check status every N seconds | 10 |## API KeySet `OPENAI_API_KEY` environment variable or pass `--api-key`.## Prompt Engineering for Video### Good prompts include:1. **Camera movement**: dolly, pan, zoom, tracking shot2. **Motion description**: swirling, rising, falling, shifting3. **Lighting**: golden hour, candlelight, dramatic rim lighting4. **Atmosphere**: steam, particles, bokeh, haze5. **Mood/style**: cinematic, commercial, lifestyle, editorial### Example prompts:**Food commercial:**```Slow dolly shot of gourmet dish, soft morning sunlight streaming through window, subtle steam rising, warm cozy atmosphere, premium food commercial aesthetic```**Lifestyle:**```Golden hour light slowly shifting across mountains, gentle breeze rustling leaves, serene morning atmosphere, premium lifestyle commercial```**Product shot:**```Cinematic close-up, dramatic lighting with warm highlights, slow reveal, luxury commercial style```## Workflow: Image → Video1. Generate image with Nano Banana Pro (or use existing)2. Pass image as `--input-image` to Sora3. Write prompt describing desired motion/atmosphere4. Script auto-resizes image to match video dimensions## Output- Videos saved as MP4- Typical file size: 1.5-3MB for 8 seconds- Resolution matches `--size` parameter

Frequently asked questions