Skip to content

gooseworks-ai/goose-skills / skills/video/animate-image

animate-image

Verified

Animate an existing product image or static ad into a short branded video using the GooseWorks Animate Images workflow, with source-image continuity and optional end-frame control.

FileKindSize
SKILL.mdskill md4.5 KB
skill.meta.jsonconfig155 B
---
name: animate-image
description: Animate an existing product image or static ad into a short branded video using the GooseWorks Animate Images workflow, with source-image continuity and optional end-frame control.
---

# Animate Image

Turn an existing product image or static ad into a short motion creative through GooseWorks. This skill uses the same backend workflow as the Animate Images interface.

## Prerequisite

This workflow requires the GooseWorks MCP connector (`https://mcp.gooseworks.ai/mcp`). It uses three tools: `ads_creative_animation_quote` (free price), `ads_creative_animate` (paid start) and `job_get` (poll). Some clients list tools by group and show the `ads` tools only after they are loaded. If `ads_creative_animation_quote` or `ads_creative_animate` is not in the advertised tool list, call `tools_load` with `{ "groups": ["ads"] }` first (free). If the tools are still missing, or `account_whoami` reports `features.animate_image: false`, explain that the connection or feature is not available and stop; do not substitute an unrelated image generator.

## Tool calls

| Step | Call | Notes |
|---|---|---|
| Quote | `ads_creative_animation_quote` | Free and read-only. Fetches nothing and reserves nothing. Returns `{ dry_run: true, estimate: { frame, duration_seconds, model, estimated_credits } }`. |
| Start | `ads_creative_animate` | Paid. Reserves credits and starts the job. Returns `{ job_id, kind: "animate", status }`. |
| Poll | `job_get` with `{ job_id, kind: "animate" }` | Read-only. `result.output_url` holds the video when `status` is `complete`; `error` explains a failure. |

Both `ads_creative_animation_quote` and `ads_creative_animate` take the same payload:

```json
{
  "brand_id": "<brand id from brand_read>",
  "creative_id": "<ad creative id from ads_creative_read or ads_save>",
  "animate": {
    "source_render_id": "<render id, or null>",
    "source_image_url": "<public https URL of the still>",
    "frame": "end",
    "prompt": "<motion prompt>",
    "duration_seconds": 5
  }
}
```

- `creative_id` is the ad creative the animation belongs to. Prefer an existing render (`source_render_id` plus its URL as `source_image_url`) so provenance is preserved.
- `frame` is `"start"` (the still is the opening frame) or `"end"` (the still is the closing frame, the default). The two can cost different credits; the quote shows the price for the frame you pass.
- `duration_seconds` must be `5` or `10`. Other values are rejected.
- Starting needs an agent-scoped token or a default agent on the account; the tool returns `agent_required` otherwise.

## Workflow

1. Resolve the brand with `brand_read` (leave out `brand_id` to list the brands). Then find the still:
   - **An existing ad:** read it with `ads_creative_read` (include renders) to get `creative_id`, `source_render_id` and the render URL.
   - **A plain image not yet in GooseWorks:** upload it with `media_upload` under the brand, then save it as an ad creative with `ads_save` (pass the `media_id`; free). `ads_save` returns `creative_id`, `render_id` and `output_url`; use them as `creative_id`, `source_render_id` and `source_image_url`.
2. Clarify the motion goal, duration (5 or 10 seconds), and whether the user wants the source image as the start frame or the end frame.
3. Write a motion prompt describing camera movement, subject movement, environment movement, pacing, and what must remain unchanged. Do not redesign the product or add unsupported claims.
4. Call `ads_creative_animation_quote` and show the user `estimated_credits` exactly as the tool returns it. Never convert it to dollars or do your own math. Ask for their yes to that credit number.
5. After their yes, call `ads_creative_animate` once with the same payload. Save the returned `job_id`.
6. Poll `job_get` with `kind: "animate"` every few seconds until `status` is `complete` or `failed`. Never start the same animation again while it runs; a second start pays again.
7. Return `result.output_url` and the source image used. If it fails, report the error in plain words before proposing a retry.

## Rules

- Ask before spending credits. The quote is free; every `ads_creative_animate` call is a paid generation.
- Never start without the user's explicit yes to the quoted credits.
- Money is the credit number the quote returns. Never show dollars.
- Preserve product shape, logo, packaging, and on-image copy unless the user explicitly requests a change.
- Prefer subtle, physically plausible motion for product shots and graphic ads.
- A new prompt for an already-running job is a new paid generation; quote it and ask again.
planning-and-task-breakdownaddyosmani/agent-skillsBreaks work into ordered tasks. Use when you have a spec or clear requirements and need to break work into implementable tasks. Use when a task feels too large to start, when you need to estimate scope, or when parallel work is possible.Stars: 119kUpdated Claude CodeCodexVerifiedInstall
screenpipethedotmack/claude-memSearch screen and audio history recorded by Screenpipe and optionally save selected context into claude-mem. Use when the user asks to recall desktop activity, a meeting, or something seen in another app through Screenpipe.Stars: 118kUpdated Claude CodeCodexVerifiedInstall
contact-widgetnexu-io/open-designSelf-contained floating chat widget with welcome screen, social links, meeting button, and message input. Single HTML file, zero dependencies.Stars: 108kUpdated Claude CodeCodexVerifiedInstall
meeting-notesnexu-io/open-designMeeting notes page — title bar with attendees, agenda checklist, decisions block, action items table with owners + dates, and a "next meeting" footer. Use when the brief mentions "meeting notes", "minutes", "1:1 notes", "all-hands recap", or "会议纪要".Stars: 108kUpdated Claude CodeCodexVerifiedInstall