Communitygithub.com

AKCodez/higgsfield-claude-skills

Pipeline completo de vídeo UGC — gera uma imagem de personagem no Higgsfield e depois cria um vídeo Seedance 2.0 a partir dela. Orquestra o fluxo completo, do prompt de imagem ao vídeo UGC finalizado.

O que é higgsfield-claude-skills?

Este skill automatiza todo o pipeline de criação de vídeos UGC (conteúdo gerado por usuário) para anúncios, utilizando a plataforma Higgsfield com Seedance 2.0. Ele começa gerando uma imagem de personagem a partir de um prompt textual e, em seguida, navega para a página de criação de vídeo, seleciona a imagem gerada, insere um prompt de vídeo UGC (testemunhal, demonstração de produto, unboxing, reação ou estilo de vida) e aciona a geração do vídeo. Tudo é feito automaticamente via Playwright, dispensando intervenção manual entre as etapas. O skill é útil para profissionais de marketing, criadores de conteúdo e desenvolvedores que desejam produzir rapidamente anúncios em vídeo com um personagem consistente e estilo autêntico de UGC. Ele suporta as plataformas Claude Code, Cursor e Codex, desde que as ferramentas MCP do Playwright estejam habilitadas. O fluxo inclui tratamento de erros para problemas comuns, como sessão expirada, créditos insuficientes ou falhas no editor Lexical.

Funciona com✓Claude Code~Codex CLI✓Cursor
npx skills add https://github.com/AKCodez/higgsfield-claude-skills/tree/HEAD/ugc-video-auto

Perguntar na sua IA favorita

Abre um novo chat com esta habilidade de agente já pré-carregada.

Documentação

Vídeo UGC Auto — Pipeline Completo via Playwright

Este skill orquestra o pipeline completo de vídeos UGC no Higgsfield: gera uma imagem de personagem → seleciona-a para vídeo → adiciona um prompt de vídeo UGC → gera um vídeo Seedance 2.0. Tudo automatizado via Playwright.


Visão Geral do Pipeline

Passo 1: Gerar imagem do personagem  →  /image/soul-v2
Passo 2: Navegar para página de vídeo  →  /create/video?model=seedance_2_0
Passo 3: Selecionar imagem da galeria →  Diálogo de upload → Aba "Gerações de Imagem"
Passo 4: Escrever prompt de vídeo UGC    →  Editor Lexical (contenteditable)
Passo 5: Configurar e gerar      →  Clicar em Gerar

Pré-requisitos

  • O usuário deve estar logado no higgsfield.ai na sessão do navegador Playwright
  • O plugin Playwright MCP deve estar habilitado
  • Carregue cada ferramenta Playwright com ToolSearch antes do primeiro uso

Requisitos de Entrada

O usuário fornece:

  1. Descrição do personagem OU um prompt de imagem pré-pronto (invoque /ugc-hot-girl para gerar um)
  2. Contexto do produto/marca — o que o vídeo UGC está anunciando
  3. Estilo do vídeo — testemunhal, demonstração de produto, unboxing, reação, etc.

Substituições opcionais:

  • Modelo de imagem: Soul 2.0 (padrão, melhor para retratos)
  • Modelo de vídeo: Seedance 2.0 (padrão)
  • Duração: 5s, 8s (padrão), 10s
  • Proporção: Auto, 16:9, 9:16 (TikTok/Reels), 1:1
  • Resolução: 720p (padrão), 1080p

Fluxo de Automação Completo

Fase 1: Gerar a Imagem do Personagem

Passo 1.1: Navegar para geração de imagem

browser_navigate → url: "https://higgsfield.ai/image/soul-v2"

Aguardar carregamento da página, tirar um instantâneo.

Passo 1.2: Inserir o prompt da imagem

Encontre a caixa de texto (ID Playwright: hf:tour-image-prompt, placeholder: "Descreva a cena que você imagina"):

browser_click → ref: <ref_caixa_texto>, element: "Caixa de texto do prompt da imagem"
browser_type → ref: <ref_caixa_texto>, text: "<prompt da imagem do personagem>"

Se o usuário não forneceu um prompt de imagem, use /ugc-hot-girl para gerar um primeiro.

Passo 1.3: Gerar a imagem

Encontre o botão Gerar (mostra "Gerar XXXX gerações gratuitas restantes"):

PEÇA CONFIRMAÇÃO AO USUÁRIO — isso usa créditos/gerações gratuitas.

browser_click → ref: <ref_botao_gerar>, element: "Botão Gerar"

Passo 1.4: Aguardar a geração

browser_wait_for → time: 20

Tire uma captura de tela. Verifique se a nova imagem aparece como o primeiro item na grade de Histórico. Confirme verificando se o innerHTML do primeiro elemento da grade contém uma tag <img> com uma URL de asset recente.


Fase 2: Criar o Vídeo a Partir da Imagem Gerada

Passo 2.1: Navegar para a página de vídeo Seedance 2.0

browser_navigate → url: "https://higgsfield.ai/create/video?model=seedance_2_0"

Aguardar carregamento da página, tirar um instantâneo. Confirme que "Seedance 2.0" aparece no botão Modelo.

Passo 2.2: Abrir o diálogo de upload de mídia

Encontre a área de upload — procure por generic [cursor=pointer] contendo:

  • paragraph: Fazer upload de mídia
  • paragraph: Imagem, Vídeo ou Áudio
browser_click → ref: <ref_area_upload>, element: "Área de upload de mídia"

Isso abre um diálogo com abas: Uploads, Gerações de Imagem, Gerações de Vídeo, Elementos, Curtidos.

Passo 2.3: Alternar para a aba Gerações de Imagem

browser_click → ref: <ref_aba_geracoes_img>, element: "Aba Gerações de Imagem"

Procure por button "Gerações de Imagem" na barra de abas do diálogo.

Passo 2.4: Selecionar a imagem gerada

A imagem gerada mais recentemente é o primeiro item na grade.

Inicialmente aparece como um button "Verificar elegibilidade". Clique nele:

browser_click → ref: <ref_primeira_imagem>, element: "Primeira imagem (geração mais recente)"

Após clicar, o botão se transforma em um generic [cursor=pointer] com uma prévia da imagem e uma marca de verificação verde — indicando que está selecionada e elegível.

Importante: O primeiro botão "Verificar elegibilidade" na lista é sempre a imagem mais recente. Após clicar, sua referência desaparece do instantâneo e é substituída por um novo elemento genérico.

Passo 2.5: Fechar o diálogo

browser_press_key → key: "Escape"

Tire um instantâneo. Verifique:

  • A área de upload não mostra mais o texto "Fazer upload de mídia"
  • Em vez disso, mostra um generic [cursor=pointer] com elementos de imagem aninhados (miniaturas de 48px)
  • Os antigos paragraph: Fazer upload de mídia e paragraph: Imagem, Vídeo ou Áudio desapareceram

Passo 2.6: Limpar qualquer prompt existente

A página de vídeo usa um editor de texto rico Lexical (div contenteditable), NÃO uma caixa de texto padrão. Para limpá-lo:

browser_evaluate → function: "() => { const el = document.querySelector('[data-lexical-editor]'); el.focus(); el.click(); }"
browser_press_key → key: "Control+a"
browser_press_key → key: "Backspace"

Tire um instantâneo. A caixa de texto agora deve mostrar o placeholder: "Descreva sua cena em detalhes. Use @ para referenciar assets"

Passo 2.7: Inserir o prompt de vídeo UGC

Após limpar, tire um instantâneo para obter a nova referência da caixa de texto. Em seguida, digite lentamente (necessário para o editor Lexical):

browser_type → ref: <ref_caixa_texto>, text: "<prompt de vídeo UGC>", slowly: true

Modelos de Prompt de Vídeo UGC (escolha com base no estilo):

Testemunhal / Talking Head:

A mulher da @image1 está falando diretamente para a câmera com gestos naturais das mãos, iluminação dourada de hora dourada, vibração autêntica casual. Ela fala com entusiasmo, inclinando-se ligeiramente para dar ênfase. Fundo bokeh suave, profundidade de campo rasa. Textura de pele natural, movimento labial realista, estilo UGC testemunhal do TikTok. Câmera na mão suave, 24fps.

Demonstração de Produto:

A mulher da @image1 segura um produto em direção à câmera, virando-o para mostrar diferentes ângulos. Expressão animada genuína, olhos arregalados. Iluminação de anel de luz, fundo limpo. Ela aponta para as características do produto, balançando a cabeça com entusiasmo. Enquadramento selfie close-up, qualidade de vídeo de iPhone, sensação UGC autêntica.

Reação / Unboxing:

A mulher da @image1 abre um pacote com antecipação animada, puxando um produto e reagindo com genuíno deleite. Expressão surpresa, boca aberta, depois se abrindo em um sorriso largo. Iluminação natural de quarto, ambiente casual. Sensação de câmera na mão, energia de unboxing autêntica, estilo TikTok.

Antes/Depois:

A mulher da @image1 começa parecendo cética, tocando o rosto duvidosamente. Depois aplica um produto, e sua expressão se transforma em admiração, tocando a pele incrédula. Anel de luz suave, ambiente de espelho de banheiro. Momento de transformação de divisão, reação genuína, testemunhal UGC.

Estilo de Vida / Dia na Vida:

A mulher da @image1 caminha por um espaço moderno e iluminado, interagindo casualmente com um produto como parte de sua rotina. Luz natural da manhã, movimento relaxado, energia autêntica e espontânea. A câmera segue com rastreamento suave, profundidade de campo rasa. Conteúdo de estilo de vida aspiracional, mas identificável.

Passo 2.8: Configurar opções de vídeo (opcional)

As configurações padrão funcionam bem para a maioria dos UGC:

  • Duração: 8s (bom para formato curto)
  • Proporção: Auto (ou 9:16 para TikTok/Reels)
  • Resolução: 720p

Para alterar a proporção para vertical do TikTok:

browser_click → ref: <ref_botao_proporcao>, element: "Seletor de proporção"

Em seguida, selecione "9:16" no menu suspenso.

Passo 2.9: Gerar o vídeo

Tire uma captura de tela mostrando o estado final do formulário.

PEÇA CONFIRMAÇÃO AO USUÁRIO — a geração de vídeo custa mais créditos do que imagens.

O botão Gerar mostra o custo em créditos (ex.: "Gerar 30 20"):

browser_click → ref: <ref_botao_gerar_video>, element: "Botão Gerar vídeo"

Passo 2.10: Monitorar a geração

Após clicar em Gerar:

  1. O vídeo entra na fila de geração
  2. Verifique a aba Histórico para progresso
  3. Tire capturas de tela periodicamente para mostrar o status
  4. Vídeos Seedance 2.0 normalmente levam de 1 a 3 minutos

Referência de Padrões de Elementos Chave

Página de Geração de Imagem (/image/soul-v2)

ElementoPadrão
Caixa de texto do prompttextbox com ID hf:tour-image-prompt
Seletor de modelogroup > button contendo "Soul 2.0"
Proporção de aspectobutton mostrando "3:4"
Resoluçãobutton mostrando "2k"
Botão Gerarbutton "Gerar XXXX gerações gratuitas restantes"
Primeiro resultadoPrimeiro filho generic na grade de Histórico

Página de Criação de Vídeo (/create/video)

ElementoPadrão
Área de upload (vazia)generic [cursor=pointer] com paragraph: Fazer upload de mídia
Área de upload (preenchida)generic [cursor=pointer] com miniaturas de imagem aninhadas, sem texto "Fazer upload de mídia"
Diálogo de uploaddialog com barra de abas: Uploads, Gerações de Imagem, etc.
Aba Gerações de Imagembutton "Gerações de Imagem" no diálogo
Primeira imagem na galeriaPrimeiro button "Verificar elegibilidade" na grade do diálogo
Imagem selecionadageneric [cursor=pointer] com img aninhada (substitui o botão Verificar elegibilidade)
Editor de prompt[data-lexical-editor] div contenteditable
Caixa de texto do prompt (no instantâneo)textbox [active] após focar o editor Lexical
Botão Modelobutton "Modelo" contendo "Seedance 2.0"
Botão Duraçãobutton "Duração"
Botão Proporçãobutton "Proporção Auto"
Botão Resoluçãobutton "Resolução 720p"
Botão Gerarbutton "Gerar XX XX" com custo em créditos

Tratamento de Erros

  • Não logado: Peça ao usuário para fazer login (! open https://higgsfield.ai)
  • Barra de prompt de imagem ausente: Atualize a página — é um bug intermitente da plataforma
  • "Verificar elegibilidade" não se transforma: A imagem pode não ser compatível com Seedance 2.0. Tente uma imagem diferente ou regenere
  • Editor Lexical não limpa: Tente triplo clique para selecionar tudo, depois Backspace. Ou use browser_evaluate para limpar innerHTML
  • Diálogo não fecha com Escape: Clique fora da área do diálogo
  • Créditos insuficientes: avise o usuário antes de gerar. Vídeo custa mais do que imagens
  • Referências obsoletas: Sempre tire um instantâneo fresco antes de cada interação. As referências mudam após qualquer alteração de estado da página

Exemplo de Fluxo de Trabalho Ponta a Ponta

Usuário: "Crie um vídeo de anúncio UGC com uma garota bonita promovendo meu novo sérum para cuidados com a pele"

1. Invoque /ugc-hot-girl → gera prompt de imagem de beleza/cuidados com a pele:
   "Jovem atraente, início dos 20 anos, pele clara e brilhante, cabelo castanho escuro em
    coque bagunçado... iluminação de anel de luz... fotorrealista, 4K..."

2. Fase 1 — Geração de Imagem:
   → Navegue para /image/soul-v2
   → Digite o prompt da imagem
   → Confirme com o usuário → Clique em Gerar
   → Aguarde 15-20s → Imagem aparece na grade ✓

3. Fase 2 — Criação de Vídeo:
   → Navegue para /create/video?model=seedance_2_0
   → Clique na área de upload → Aba Gerações de Imagem
   → Clique na primeira imagem (Verificar elegibilidade) → Escape
   → Imagem carregada no formulário ✓
   → Limpe o prompt antigo → Digite o prompt de testemunhal UGC:
     "A mulher da @image1 segura um pequeno frasco de sérum, examinando-o
      com genuína curiosidade. Ela aplica uma gota na ponta do dedo, toca
      sua bochecha, e sua expressão se ilumina de deleite..."
   → Defina proporção para 9:16 (TikTok)
   → Confirme com o usuário → Clique em Gerar
   → Vídeo gerando... concluído ✓

4. Relatório: "Seu vídeo UGC está pronto! Verifique a aba Histórico."

Referência de Skills do Pipeline

PassoSkillO que faz
1/ugc-hot-girlGera o prompt de imagem do personagem
2/higgsfield-image-autoAutomatiza apenas a etapa de geração de imagem
3/seedance-auto-generateAutomatiza apenas a etapa de geração de vídeo (a partir de arquivo local)
Completo/ugc-video-autoEste skill — executa todo o pipeline de ponta a ponta

Você pode usar os skills individuais separadamente ou invocar /ugc-video-auto para executar tudo de uma vez.

Individual skills in this repo

This repo contains 11 individual skills — each has its own dedicated page.

AKCodez/higgsfield-claude-skills

Generate cinematic film-style video prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants cinematic, film-like, movie-quality, Hollywood-style, dramatic, or professional film-quality AI video. Triggers on: cinematic, film look, movie scene, dramatic lighting, depth of field, lens flare, anamorphic, letterbox, noir, epic, Steadicam, dolly, crane shot, or any cinematic video generation request. Always use this skill even if the user doesn't explicitly say "cinematic" but describes a film-like aesthetic.

AKCodez/higgsfield-claude-skills

Generate 3D CGI and rendered video prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants 3D rendered, CGI, Pixar-style, Unreal Engine, photorealistic 3D, computer-generated, or digitally rendered video content. Triggers on: 3D animation, CGI, rendered, Blender, Unreal Engine, octane render, ray tracing, volumetric, subsurface scattering, physically based rendering, or any 3D/CG video request. Always use even if the user just says "make it look 3D" or describes a rendered aesthetic.

AKCodez/higgsfield-claude-skills

Generate cartoon and animation style video prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants cartoon, 2D animation, cel-shaded, hand-drawn, illustrated, flat animation, or motion graphics animation style video. Triggers on: cartoon, animation, cel shading, hand-drawn, illustrated, flat design animation, vector animation, retro cartoon, rubber hose, motion graphics, or any cartoon/animated style request. Use even for vague requests like "make it look animated" or "fun colorful style.

AKCodez/higgsfield-claude-skills

Convert comic book panels, manga pages, webtoons, and illustrated storyboards into animated video using Seedance 2.0 on Higgsfield. Use whenever the user wants to animate comics, bring illustrations to life, convert manga to video, animate storyboards, or create motion from static sequential art. Triggers on: comic to video, manga animation, panel animation, storyboard to video, webtoon animation, comic book motion, sequential art, graphic novel animation, or any illustrate-to-animate request. Use even when user says "make this drawing move" or "animate this page.

AKCodez/higgsfield-claude-skills

Generate e-commerce product advertisement video prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants product ads, e-commerce videos, product showcases, unboxing, product demos, shopping ads, fashion ads, beauty ads, food ads, or any commercial product video for online selling. Triggers on: product ad, e-commerce, product showcase, Amazon video, Shopify ad, Instagram shop, TikTok shop, product commercial, fashion video, beauty ad, food ad, product demo, dropshipping video, or any product promotional video request. Use even for "make a video for my product" or "product promo.

AKCodez/higgsfield-claude-skills

Generate product 360° turntable, multi-angle showcase, and product reveal video prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants a product rotation video, turntable showcase, product reveal, 360 view, multi-angle product display, product beauty shot, hero product video, or unboxing reveal. Triggers on: product 360, turntable, product rotation, multi-angle, product reveal, product showcase, hero shot, beauty shot, product spin, unboxing, or any request to showcase a physical product from multiple angles. Use even for "show my product from all sides" or "make a product video.

AKCodez/higgsfield-claude-skills

Generate music video and beat-synced visual content prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants to create a music video, lyric video, beat-synced visuals, performance video, concert visual, album art animation, or music-driven visual content. Triggers on: music video, lyric video, beat sync, music visualization, performance video, concert visual, album visual, song video, music clip, beat drop visual, rhythm sync, or any music-driven video request. Use even for "make visuals for my song" or "video for this track.

AKCodez/higgsfield-claude-skills

Generate viral social media hook video prompts for TikTok, Instagram Reels, and YouTube Shorts using Seedance 2.0 on Higgsfield. Use whenever the user wants to create scroll-stopping hooks, viral short-form video, attention-grabbing openers, TikTok content, Reels content, Shorts content, or any social-media-optimized video. Triggers on: social media video, TikTok, Instagram Reels, YouTube Shorts, viral video, hook, scroll-stopper, short-form, trending, engagement, views, or any request for social media video content. Use even for "make something that gets views" or "viral content.

AKCodez/higgsfield-claude-skills

Generate brand storytelling and narrative video prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants to create a brand story video, company origin story, mission video, about us video, brand film, corporate narrative, founder story, brand anthem, company culture video, or emotional brand content. Triggers on: brand story, brand video, company story, origin story, about us, mission video, brand film, brand anthem, corporate video, company culture, founder story, brand narrative, or any request for brand/company storytelling video. Use even for "tell our company story" or "make a video about our mission.

AKCodez/higgsfield-claude-skills

Generate real estate, architecture, and interior design showcase video prompts for Seedance 2.0 on Higgsfield. Use whenever the user wants property tours, real estate listings, architecture showcases, interior design videos, home staging content, property marketing, virtual tours, construction reveals, or any real estate/architecture video. Triggers on: real estate, property, house, apartment, architecture, interior design, home tour, listing video, property marketing, virtual tour, building, construction, renovation, home staging, or any real estate/architecture video request. Use even for "make a video for my listing" or "showcase this property.

AKCodez/higgsfield-claude-skills

Generate a detailed AI image prompt for creating an attractive female UGC ad character. Use when the user wants to create a "hot girl" character image for UGC ads, influencer-style content, product testimonials, or social media ad creatives. Triggers on requests like "create a UGC girl", "hot girl for ads", "female influencer image", "UGC character", "testimonial girl", or any request for a female character for ad/UGC content.

Habilidades Relacionadas