Prompt to Video

Turn a one-line idea into a full short video — Revid writes the script, picks visuals, and assembles the cut. Use when the user has a topic but no script.

Security Scan

The skill's requests and instructions are consistent with its stated purpose (calling Revid's render/status endpoints using a REVID_API_KEY); nothing requested or described appears disproportionate or unrelated.

Purpose & Capability

Name/description map directly to calling Revid's API to render videos. The declared config key REVID_API_KEY matches the API usage in SKILL.md and example code.

Instruction Scope

SKILL.md instructs POST /api/public/v3/render and polling /status on https://www.revid.ai and only references REVID_API_KEY. This stays within the expected scope. Note: the shipped example script uses curl and jq (network calls and local JSON manipulation); those binaries are not declared as required in registry metadata — the examples assume them but the skill itself is instruction-only.

Install Mechanism

No install spec — instruction-only. Nothing is downloaded or written to disk by the skill itself, which minimizes install-time risk.

Credentials

Only a single service credential (REVID_API_KEY) is required, which is proportional to the stated purpose. No unrelated secrets or broad system paths are requested.

Persistence & Privilege

always:false and default invocation settings are used. The skill does not request permanent system presence or privileges beyond calling the external API.

Assessment

This skill appears to do exactly what it says: call Revid's public API to render videos and poll status. Before installing, 1) confirm you trust https://www.revid.ai and that the REVID_API_KEY you provide has the minimal needed permissions; 2) avoid sending sensitive/private prompts or PII to the service (the API call will transmit the prompt and other render metadata to Revid); 3) if you plan to use the example script, ensure curl and jq are available and inspect the script (it requires REVID_API_KEY in the environment); and 4) review Revid's privacy/retention policy if your inputs include customer data or proprietary content.

Idea prompt → video

The lowest-input skill. The user types one line ("Why honey never spoils") and Revid handles everything: script, visuals, voice, music, cuts.

When to use this skill

• Source is a topic, question, or one-line concept — no script.
• The user is OK letting the AI choose the angle and structure.
• For a known script, use revid-script-to-video.
• For an idea + brand voice, use revid-product-description-to-ad.

Inputs

Field	Required	Notes
prompt	yes	The idea (one or two sentences)
stylePrompt	no	Optional tone notes
durationSeconds	no	Default 35 (s)
aspectRatio	no	Default 9:16

Step-by-step

1. Validate prompt is non-empty.
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": "prompt-to-video",
  "source": {
    "prompt":          "{ONE_LINE_IDEA}",
    "stylePrompt":     "{OPTIONAL_TONE_NOTES}",
    "durationSeconds": 35
  },
  "aspectRatio": "9:16",
  "voice":    { "enabled": true, "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",
    "videoModel": "pro",
    "imageModel": "good"
  },
  "options": {
    "promptTargetDuration": 35,
    "summarizationPreference": "summarizeIfLong",
    "soundEffects": true,
    "hasToGenerateCover": true
  },
  "render": { "resolution": "1080p", "frameRate": 30 }
}

Examples

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

Failure modes

Symptom	Fix
Script angle is generic ("Did you know…")	Add stylePrompt with a specific angle: "Open with a contrarian claim. End with a question that invites comments."
Off-niche visuals	Mention concrete subjects in the prompt: "Why honey never spoils — show beehives, ancient Egyptian jars, microscope close-ups of crystallized honey."
Too long / too short	Use durationSeconds AND options.promptTargetDuration together (some legacy paths only read one).

See also

• revid-script-to-video when you have the words.
• revid-product-description-to-ad for ads.