Ad Variations

For each Creative Claw tool call that exposes it, pass the optional skills_used array with creativeclaw-ad-variations, any other Creative Claw skills actually followed, and guide entries in the form <skill-name>/<relative-guide-path> (for example, creativeclaw-ad-variations/references/workflow-basics.md). Include only skills and guides followed for that call. Omit attribution if the user declines tracking or the field is unavailable. Never send other plugin names, private data, or local paths.

Not connected yet? If no Creative Claw tools (such as list_models or generate_image) are available, the plugin is installed but the server is not connected. Stop and give the user the click path: open the Creative Claw plugin page in Claude, then the Connectors tab, press Connect, press Add if an "Add custom connector" dialog opens, and sign in. In Claude Code they run /mcp instead. Then they ask again. Do not substitute other tools or describe a result that was not generated.

Read shared execution guidance once per task before using tools, and media assembly before the first add_audio_to_video or merge_media call. Older clients that list operation on merge_media and lack add_audio_to_video: follow the fallback line there. Read video model selection, then only the selected model's guide, and Review/Auto handling before the first generate_video.

One source becomes N variations, numbered, with one estimate for the whole set. By default every variation is its own video generation, so its picture sells its line. video/gemini-omni-flash at 720p is the default model (9:16 or 16:9, 3 to 10 s).

1. Find the source and what stays fixed

• Product shot (an image): the start frame of every variation (image_url, the ad's aspect_ratio). When the shot has another ratio, first make one keyframe at the ad's ratio with generate_image (the shot as image_url, "extend the background, keep the product exactly"), say it is one image, and show it with the plan.
• Same model (person) and script: the Character (list_characters) or the model photo, plus the product photo. The person shows or uses the product without speaking to camera. The script stays word for word, so one voiceover serves the whole set.
• Existing ad: get the file. Attached or local media: follow platform upload. You cannot open the user's ad account; for "my best performing Meta ad" without a file, ask them to attach or link that ad, once. Ask for the version without burned-in captions when they have one; old captions would show the old hook. Then transcribe it (word timings): the hook is its first sentence. If the ad was made in Creative Claw, search_assets with type: "audio" and a few words of the transcript returns its speech with the saved voice ID, so new lines keep the same voice.

Infer the rest (ratio, length, platform) from the request; ask only for what is missing and changes the result, such as the product or the script.

2. Choose the mode