topview-prompt-builder

Assembles Topview UGC video generation parameters with avatar, voice, script, and scene inputs.

9|Updated May 8, 2026
One-click install
npx skills add https://github.com/simpletibr/simplicio-loop-marketing --skill topview-prompt-builder-simpletibr
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: topview-prompt-builder
Source: https://github.com/simpletibr/simplicio-loop-marketing/tree/main/.skills/topview-prompt-builder
Command: npx skills add https://github.com/simpletibr/simplicio-loop-marketing --skill topview-prompt-builder-simpletibr

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Manually constructing Topview API calls for UGC ad videos requires juggling avatar IDs, voice IDs, script timing, aspect ratios, and mode selection, which leads to invalid requests and wasted generation credits. ## Core Features & Use Cases - Parameter Assembly: Builds the ready-to-pass parameter object for Topview MCP tools, including avatar_id, voice_id, scene, product_asset, aspect, duration, and language. - Script Timing Validation: Estimates reading time at ~2.3 words per second, trims scripts that overflow the target duration, and refuses unrecoverable overflows. - Mode Selection: Picks the correct MCP tool (topview_avatar_generate, topview_url_to_video, or topview_face_swap) based on whether a script, product URL, or try-on scenario is provided. - Use Case: A marketer needs a 15-second vertical ad with an avatar holding a perfume bottle. Provide the avatar ID, product image, script, and voice, and receive the exact Topview MCP call with a cost estimate. ## Quick Start Ask the assistant to build a Topview UGC prompt for a 15-second 9:16 ad with a given avatar, product image, script, and pt-BR voice.

Frequently Asked Questions about topview-prompt-builder

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I generate a UGC ad video with a Topview avatar?

Provide an avatar_id, product_asset, scene, script, voice_id, language, duration_seconds, and aspect. The skill validates the inputs, estimates script timing, and returns the parameter object for the topview_avatar_generate MCP tool.

How to create a product demo video from a URL with Topview?

Pass a from_url parameter with the product page link instead of a script. The skill marks the call as auto-script mode and routes it to the topview_url_to_video MCP tool, which scrapes the URL to generate the narration.

What inputs are required for Topview video generation?

Avatar_id, voice_id, aspect, and duration_seconds are mandatory, plus at least one of script or from_url. Optional inputs include scene, product_asset, language, and a cta_overlay text of up to 40 characters.

What happens if my script is too long for the video duration?

Script reading time is estimated at about 2.3 words per second. If the script overflows the target duration by more than 10 percent, it is trimmed from the end with a warning; if it still overflows, the request is refused.

When should I use Topview instead of Higgsfield or Wavespeed?

Use Topview for UGC-style ads with avatars holding products, talking-head scripts, and URL-driven demos. Choose Higgsfield for cinematic shots and Wavespeed for cheaper batch hook tests.