# UGC video auto Human Guide ## What This Is For This skill orchestrates the complete UGC ad video pipeline on Higgsfield: generate a character image → select it for video → add a UGC video prompt → generate a Seedance 2.0 video. It gives the agent a clearer input/output frame for content production: what context to ask for, what decisions to make, and what usable artifact to return. Use this as a human-readable version of the UGC video auto agent skill. It is meant for marketers, operators, founders, and other non-coders who want the workflow without reading agent-specific implementation instructions. ## When To Use This - Use this when you need a repeatable process for UGC video auto. - Use this when the task needs judgment, examples, constraints, or a clear output format rather than a one-off prompt. - Use this when you want to hand an AI assistant enough context to produce a usable marketing artifact. ## When Not To Use This - Do not use this when you only need a quick factual answer. - Do not use this when the work depends on private data you cannot share with the assistant. - Do not use this as a replacement for legal, compliance, financial, or medical review. ## What You Need Before Starting - The goal or business outcome you want. - The audience, customer segment, or market context. - Any source material the assistant should respect, such as notes, briefs, examples, URLs, or brand guidance. - Constraints such as tone, length, channel, deadline, region, or approval requirements. - A clear definition of what a good final answer should look like. ## Step-By-Step Workflow 1. State the job clearly: "Use the UGC video auto guide to help me with..." 2. Add context: audience, goal, offer, channel, source material, and constraints. 3. Ask the assistant to identify missing inputs before producing the final output. 4. Have the assistant follow the skill-specific guidance below. 5. Review the result against the final checklist and ask for revisions where needed. ## Skill-Specific Guidance - User must be **logged in** to higgsfield.ai in the Playwright browser session - **Playwright MCP** plugin must be enabled - Load each Playwright tool with `ToolSearch` before first use - **Character description** OR a pre-made image prompt (invoke `/ugc-hot-girl` to generate one) - **Product/brand context** — what the UGC video is advertising - **Video style** — testimonial, product showcase, unboxing, reaction, etc. - **Image model**: Soul 2.0 (default, best for portraits) - **Video model**: Seedance 2.0 (default) - **Duration**: 5s, 8s (default), 10s - **Ratio**: Auto, 16:9, 9:16 (TikTok/Reels), 1:1 - **Resolution**: 720p (default), 1080p - `paragraph: Image, Video or Audio` ## Decision Points And Nuance The original skill emphasizes: Pipeline Overview, Prerequisites, Input Requirements, Full Automation Flow, Phase 1: Generate the Character Image, Step 1.1: Navigate to image generation, Step 1.2: Enter the image prompt, Step 1.3: Generate the image, Step 1.4: Wait for generation, Phase 2: Create the Video from the Generated Image. Use these questions to steer the work: - What is the intended audience or buyer? - What source material must be preserved? - What should the assistant optimize for: clarity, persuasion, accuracy, speed, creativity, or conversion? - What examples represent the desired quality bar? - What should the assistant avoid? ## Common Mistakes - User must be **logged in** to higgsfield.ai in the Playwright browser session - **Playwright MCP** plugin must be enabled - **Important**: The first "Check eligibility" button in the list is always the most recent image. After clicking, its ref disappears from the snapshot and is replaced by a new generic element. - After clearing, take a snapshot to get the fresh textbox ref. Then type **slowly** (required for the Lexical editor): ## Copy-And-Paste Prompt ```text Use the UGC video auto human guide. My goal: [Describe the business outcome] Audience: [Describe who this is for] Context and source material: [Paste notes, examples, links, or existing copy] Constraints: [Tone, length, channel, timeline, must-include items, must-avoid items] Before producing the final output, ask me for any missing information that would materially improve the result. ``` ## Final Checklist - [ ] The output matches the original goal. - [ ] The audience and context are reflected in the answer. - [ ] Important constraints and source material were preserved. - [ ] The assistant made the relevant decisions explicit. - [ ] The final artifact is ready to use, review, or hand to the next person. ## Source This guide was generated from the akcodez/higgsfield-claude-skills skill entry for `ugc-video-auto`. ## Source Skill Notes These notes preserve the nuance from the original skill. Use them as supporting reference when the workflow above feels too generic. # UGC Video Auto — Full Pipeline via Playwright This skill orchestrates the complete UGC ad video pipeline on Higgsfield: generate a character image → select it for video → add a UGC video prompt → generate a Seedance 2.0 video. All automated via Playwright. --- ## Pipeline Overview ``` Step 1: Generate character image → /image/soul-v2 Step 2: Navigate to video page → /create/video?model=seedance_2_0 Step 3: Select image from gallery → Upload dialog → "Image Generations" tab Step 4: Write UGC video prompt → Lexical editor (contenteditable) Step 5: Configure & generate → Click Generate ``` --- ## Prerequisites - User must be **logged in** to higgsfield.ai in the Playwright browser session - **Playwright MCP** plugin must be enabled - Load each Playwright tool with `ToolSearch` before first use ## Input Requirements The user provides: 1. **Character description** OR a pre-made image prompt (invoke `/ugc-hot-girl` to generate one) 2. **Product/brand context** — what the UGC video is advertising 3. **Video style** — testimonial, product showcase, unboxing, reaction, etc. Optional overrides: - **Image model**: Soul 2.0 (default, best for portraits) - **Video model**: Seedance 2.0 (default) - **Duration**: 5s, 8s (default), 10s - **Ratio**: Auto, 16:9, 9:16 (TikTok/Reels), 1:1 - **Resolution**: 720p (default), 1080p --- ## Full Automation Flow ### Phase 1: Generate the Character Image #### Step 1.1: Navigate to image generation ``` browser_navigate → url: "https://higgsfield.ai/image/soul-v2" ``` Wait for page load, take a snapshot. #### Step 1.2: Enter the image prompt Find the textbox (Playwright ID: `hf:tour-image-prompt`, placeholder: "Describe the scene you imagine"): ``` browser_click → ref: , element: "Image prompt textbox" browser_type → ref: , text: "" ``` If the user hasn't provided an image prompt, use `/ugc-hot-girl` to generate one first. #### Step 1.3: Generate the image Find the Generate button (shows "Generate XXXX free gens left"): **ASK USER FOR CONFIRMATION** — this uses credits/free generations. ``` browser_click → ref: , element: "Generate button" ``` #### Step 1.4: Wait for generation ``` browser_wait_for → time: 20 ``` Take a screenshot. Verify the new image appears as the **first item** in the History grid. Confirm by checking the first grid element's innerHTML contains an `` tag with a fresh asset URL.