playbooks

home / skills / tara-shopos / shopos-prototype / video_generation

video_generation skill

/apps/api/src/skills/video_generation

This skill generates short videos for ecommerce products using Veo, transforming images or descriptions into animated assets.

npx playbooks add skill tara-shopos/shopos-prototype --skill video_generation

Review the files below or copy the command above to add this skill to your agents.

Files (1)
SKILL.md
1.1 KB
---
name: video_generation
description: Generate short videos for e-commerce products using Veo. Use this when the user asks for a video, motion, or animation of a product.
license: Apache-2.0
metadata:
  version: "1.0"
  author: ShopOS
allowed-tools:
  - generateVideo
---

# Video Generation Skill

## When to use this skill
Use this skill when the user wants to generate a video asset. Intents include:
- "Make a video of this shoe"
- "Animate this product"
- "Create a 5-second reveal video"

## Instructions
1.  **Identify Input**: Ensure you have a source image (for image-to-video) or a clear text description (for text-to-video).
2.  **Determine Parameters**:
    - Duration: Default to 5 seconds if not specified.
    - Aspect Ratio: 16:9 for web, 9:16 for social (Stories/TikTok).
3.  **Construct Tool Call**:
    - Call `generateVideo`.
    - Provide `prompt`, `image_url` (if applicable), and `aspect_ratio`.

## Examples
> User: "Create a cinematic video of this watch"
> Tool: `generateVideo`
> Args: { "prompt": "cinematic rotating shot of luxury watch", "duration": 5 }

Overview

This skill generates short product videos and motion assets for e-commerce using Veo. It converts a source image or a text prompt into a polished short video optimized for web or social platforms. Use it to quickly produce reveal, rotating, or cinematic clips for product listings and ads.

How this skill works

The skill accepts either an image URL (image-to-video) or a clear text description (text-to-video). It sets sensible defaults—5 seconds duration and platform-appropriate aspect ratios—then constructs a call to the generateVideo tool with prompt, image_url (if provided), duration, and aspect_ratio. The output is a short MP4-style asset ready for preview and download.

When to use it

  • You need a short product clip for a product page or ad
  • The user requests animation, motion, or a reveal of a product
  • Converting product photos into rotating or cinematic videos
  • Creating social-native vertical assets (Stories, Reels, TikTok)
  • Rapid prototyping of product video variations for A/B testing

Best practices

  • Provide a high-resolution, well-lit product image when available
  • Include a concise prompt describing motion style, camera movement, and mood
  • Specify aspect_ratio explicitly for target platform (16:9 web, 9:16 social)
  • Keep duration short (3–7 seconds) unless a longer demo is requested
  • Request multiple variants with small prompt tweaks for comparison

Example use cases

  • Create a 5-second cinematic rotating shot of a luxury watch from a product photo
  • Generate a 9:16 vertical reveal video for a sneaker to use in Stories
  • Produce a short animated product highlight from a text description for an ad
  • Make multiple 5-second variants with different lighting moods for A/B testing
  • Convert a flat apparel image into a subtle 3D rotation for the storefront

FAQ

What inputs are required?

Either a high-quality image URL for image-to-video or a clear text prompt for text-to-video. Specify duration and aspect_ratio if you need non-defaults.

What are the default settings?

Default duration is 5 seconds. Default aspect ratio is 16:9 for web; choose 9:16 for social verticals.