Product Description to Ad

Turn a product description (free-form text — no URL needed) into a punchy 15–30 second AI-generated ad with hooks, CTA, and visuals. Use when the user pastes...

Security Scan

The skill's requirements and instructions match its stated purpose (generating short ads via Revid's render API); it only needs a Revid API key and makes network calls to revid.ai — no other unexplained privileges or installs were found.

Purpose & Capability

The skill claims to convert product descriptions into short ads and its SKILL.md and examples call Revid's /render and /status endpoints using a REVID_API_KEY. That is coherent. Minor inconsistency: the registry metadata lists no required binaries, yet the provided example script uses curl and jq; also the skill metadata declares REVID_API_KEY as a config path while the example uses it as an environment variable.

Instruction Scope

Runtime instructions are narrowly scoped: validate prompt length, build the JSON payload, POST /render, poll /status, and return the video URL. The instructions do not ask the agent to read unrelated system files, other credentials, or transmit data to endpoints other than revid.ai (the behaviour is appropriate for the described purpose).

Install Mechanism

There is no install specification (instruction-only), so nothing is written to disk or downloaded by an installer. This is lower risk. The included example shell script will perform network calls when run but there is no packaged installer or external archive download.

Credentials

The skill only requires a single service credential (REVID_API_KEY), which is appropriate for calling Revid's API. Note: the SKILL metadata lists REVID_API_KEY under config, while the example script expects it as an environment variable; the API key is sent in an HTTP header to revid.ai — so treat it as a sensitive secret. No other unrelated credentials are requested.

Persistence & Privilege

always is false and the skill does not request persistent presence or modify other skills or system-wide settings. The skill does permit autonomous invocation by default (disable-model-invocation: false), which is normal for user-invocable skills and not by itself a problem.

Assessment

This skill appears to do what it says: it builds a JSON payload and posts your product description to Revid's public API to render an ad, using a single REVID_API_KEY. Before installing or running it: (1) Be prepared to provide your Revid API key — the key is transmitted in an HTTP header to https://www.revid.ai and should be treated as a secret. (2) The bundled example script uses curl and jq even though the registry metadata lists no required binaries; ensure those tools are present or run equivalent HTTP calls. (3) Only send product text you are comfortable sharing with Revid (no private secrets). (4) Confirm any billing/credit usage with Revid (rendering video may consume paid credits). (5) If you need the skill to be prevented from autonomous use, disable model invocation or avoid granting it automatic invocation in your agent settings. Overall the skill is coherent and proportionate, but verify the API key scope and trustworthiness of revid.ai before supplying credentials.

Product description → AI ad

Take a paragraph (or bullet list) describing a product and produce a polished short-form ad. The ad-generator workflow writes the hook + body + CTA itself based on the description.

When to use this skill

• The user pastes a product description, spec sheet, or feature list — not a URL.
• They want hook → benefit → CTA structure (a commercial).
• They have no avatar / talking-head requirement (use revid-blog-to-avatar-video for that).
• For a live URL, use revid-shopify-product-promo.

Inputs

Field	Required	Notes
prompt	yes	The product description (the AI uses it as the brief)
stylePrompt	no	Optional brand voice notes (e.g. "Apple-like, calm, premium")
aspectRatio	no	Default 9:16
targetDuration	no	Default 22 (s)
mediaItems	no	If you have product images, pass them in media.provided

Step-by-step

1. Validate prompt has at least ~30 words (otherwise the ad is too thin).
2. Build the payload below; if product images were provided, slot them into media.provided and set media.useOnlyProvided: false (mix with stock).
3. POST /render.
4. Poll /status.
5. Return videoUrl.

API call template

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

{
  "workflow": "ad-generator",
  "source": {
    "prompt":      "{PRODUCT_DESCRIPTION}",
    "stylePrompt": "{OPTIONAL_BRAND_VOICE_NOTES}",
    "durationSeconds": 22
  },
  "aspectRatio": "9:16",
  "voice":    { "enabled": true, "stability": 0.55, "speed": 1.05, "language": "en-US" },
  "captions": { "enabled": true, "position": "middle", "autoCrop": true },
  "music":    { "enabled": true, "syncWith": "beats", "trackName": "ad-energetic" },
  "media": {
    "type": "stock-video",
    "density": "high",
    "animation": "dynamic",
    "quality": "ultra",
    "imageModel": "ultra",
    "videoModel": "ultra",
    "turnImagesIntoVideos": true,
    "applyStyleTransfer": false,
    "provided": []
  },
  "options": {
    "targetDuration": 22,
    "promptTargetDuration": 22,
    "summarizationPreference": "summarizeIfLong",
    "soundEffects": true,
    "addStickers": true,
    "hasToGenerateCover": true,
    "coverTextType": "hook"
  },
  "render": { "resolution": "1080p", "frameRate": 30 }
}

ad-generator defaults to higher visual quality than article-to-video because ads compete on the first second. If credits are tight drop quality to pro.

Examples

• examples/aeropods-ad.json — payload with brand notes.
• examples/run.sh — accepts description as a file or positional arg.

Failure modes

Symptom	Fix
Hook is generic	Make prompt specific. "Wireless earbuds" → meh. "Wireless earbuds with adaptive ANC and 38h battery for $179" → strong.
Ad reads like a feature list, not a hook	Add stylePrompt: "Lead with a question or emotional hook. Save specs for the middle. End with the price + a single CTA."
Visuals don't match the product	Pass real product images via media.provided: [{ url, type: "image" }]. The AI will weave them in.
Voice rushes	Lower voice.speed to 0.95.
Too many on-screen stickers	options.addStickers: false.

See also

• revid-shopify-product-promo — same goal but starts from a URL.
• revid-script-with-custom-media — full creative control.