Script to Video

Turn an already-written script into a video with voiceover, auto-cut stock visuals, and captions. Use when the user has the words and wants Revid to handle p...

Security Scan

The skill does what it says — it posts a user-provided script to Revid's render API and polls status; its requirements and behavior are coherent with that purpose.

Purpose & Capability

Name/description match the behavior: SKILL.md and examples call Revid's /render and /status endpoints and require a REVID_API_KEY, which is appropriate for a Revid integration.

Instruction Scope

SKILL.md stays on-task (send script text, set options, poll status). It instructs sending user script data to https://www.revid.ai (expected). The example run.sh reads a local script file or uses the bundled example, so it will transmit supplied text — avoid embedding secrets. The example script uses curl and jq, but the skill metadata does not declare required binaries; that's a minor inconsistency to be aware of.

Install Mechanism

No install spec (instruction-only) — nothing is downloaded or written to disk by an installer, which minimizes install-time risk.

Credentials

Only REVID_API_KEY is required and is appropriate for authenticating to Revid's API. No other credentials or unrelated environment variables are requested.

Persistence & Privilege

always is false and the skill does not request elevated or persistent platform-wide privileges.

Assessment

This skill is coherent but keep these practical cautions in mind before installing: (1) The skill transmits whatever script text you provide to Revid (https://www.revid.ai) — do not include passwords, API keys, personal data, or other secrets in scripts. (2) The included example run.sh requires curl and jq to run but the skill metadata does not list required binaries — ensure your environment has these tools or update the requirements. (3) Verify you trust Revid and the scope of your REVID_API_KEY; prefer a key with minimal permissions and rotate it if you suspect exposure. (4) Test with non-sensitive content first to confirm behavior and costs. If you want these inconsistencies fixed, ask the author to declare required binaries and to document any rate limits, data retention, and how API keys are used/stored.

Script → video

The script-to-video workflow is the lowest-friction path: you bring the words, Revid brings the visuals + voice + captions + edit.

When to use this skill

• The user pastes a finished script (or generates one in-conversation).
• They want full creative control over the words.
• They are happy with stock visuals (otherwise see revid-script-with-custom-media).
• For an idea-to-video flow, use revid-prompt-to-video.

Inputs

Field	Required	Notes
text	yes	The script. Use line breaks for scene boundaries.
aspectRatio	no	Default 9:16
voiceId	no	Pick to match the script tone
targetDuration	no	Auto-derived from script length if omitted

Step-by-step

1. Validate text is non-trivial (>30 words) and within practical limits (~1500 words for a 5-min video).
2. POST /render.
3. Poll /status.

API call template

POST /api/public/v3/render
Host: www.revid.ai
Content-Type: application/json
key: $REVID_API_KEY

{
  "workflow": "script-to-video",
  "source":   { "text": "{SCRIPT}" },
  "aspectRatio": "9:16",
  "voice":    { "enabled": true, "voiceId": "aria-en-us", "stability": 0.6, "speed": 1.0, "language": "en-US" },
  "captions": { "enabled": true, "position": "middle", "autoCrop": true },
  "music":    { "enabled": true, "syncWith": "beats" },
  "media": {
    "type": "stock-video",
    "density": "medium",
    "animation": "soft",
    "quality": "pro",
    "imageModel": "good",
    "videoModel": "pro"
  },
  "options": {
    "summarizationPreference": "no-summarization",
    "soundEffects": true,
    "hasToGenerateCover": true
  },
  "render": { "resolution": "1080p", "frameRate": 30 }
}

summarizationPreference: "no-summarization" — the user wrote the script for a reason. Don't paraphrase it.

Examples

• examples/honey-script.json
• examples/run.sh

Failure modes

Symptom	Fix
Script too long → exceeds context	Either split into multiple /render calls (one per chapter) or set summarizationPreference: "summarize".
Voice mispronounces brand names	Inline phonetic spelling in the script ("Revid (rev-id)").
Visuals don't match niche topic	Pre-author a few key shots and switch to revid-script-with-custom-media.
Music drowns the voice	Lower music duck — currently no direct knob; switch music.enabled: false and add ambient sound effects via options.soundEffects: true.

See also

• revid-script-with-custom-media for full visual control.
• revid-prompt-to-video when you want Revid to write the script too.
• revid-tweet-to-talking-head for short scripts with an avatar.