hleliofficiel/gent-skill

Gent Skill

Habilidade profissional e opinativa de produção visual — combina o melhor da geração de imagens, síntese de vídeo, design de nível Figma e edição FFmpeg, tudo unificado em um único pipeline de provedor. Habilidade independente que você pode instalar em qualquer OpenClaw.

Quando usar

Frases de gatilho (apenas quando o usuário solicitar explicitamente geração/edição/design):

• "Gere uma imagem com o prompt X", "crie uma imagem cinematográfica"
• "Crie uma intro de vídeo para gent-skill", "faça um vídeo de introdução"
• "Projete isso no layout do Figma", "crie um design de overlay no Figma"
• "Edite este vídeo: cortar/comprimir/mesclar", "extraia áudio do vídeo", "adicione narração ao vídeo"
• "Combine esta imagem com texto no Figma" NÃO acione em menções isoladas como "Istambul", "foto" ou "design" sem intenção explícita de criação.

Arquitetura (habilidades mescladas)

• Geração de imagens — habilidade beauty-generation-api (endpoint de referência: https://gen1.diversityfaces.org/api/generate)
• Orquestração de vídeo — habilidade ai-video-gen (generate_video.py, images_to_video.py, add_voiceover.py)
• Edição de vídeo — habilidade ffmpeg-video-editor (padrões SKILL.md para corte, mesclagem, redimensionamento, efeitos)
• Design — habilidade figma (auditoria visual, ativos, overlays)

Sua instalação precisa apenas de BEAUTY_API_KEY para imagens. Nenhum plugin adicional necessário.

Fluxo de trabalho

1. Classificação de intenção — imagem | intro de vídeo | edição de vídeo | design
2. Geração (se necessário) — use gen1.diversityfaces.org via os endpoints da beauty-generation-api. Aviso de privacidade: prompts/texto que você enviar serão processados pelo serviço externo. NÃO inclua senhas, tokens, dados pessoais ou confidenciais nos prompts. Envie apenas briefs criativos não sensíveis. Isso está de acordo com o uso pretendido pelo provedor.
3. Camada de design — skill Figma para overlays de layout, tipografia, marcas
4. Montagem — padrões ffmpeg-video-editor para transições, escala, zoom, drawtext; orquestração ai-video-gen para ponta a ponta
5. Entrega — arquivos de saída como anexos reais (ferramenta message, array attachments). Nunca apenas markdown.

Pipeline de imagem (JPEG obrigatório)

• Provedor: gen1.diversityfaces.org
• Base: https://gen1.diversityfaces.org
• Endpoint de geração: /api/generate/custom
• Status: /api/status/{prompt_id}
• Download: /api/image/{filename}
• Env: BEAUTY_API_KEY
• Formato: converta todas as saídas para JPEG antes de enviar, independentemente do formato de origem.
• Validar: arquivo existe, legível, cabeçalho JPEG válido.
• Enviar: message(action=send, target=<chat>, attachments:[{type:"image", media:"/local/path.jpg", mimeType:"image/jpeg"}])

Pipeline de vídeo

• Principal: skills/ai-video-gen/ (generate_video.py, images_to_video.py, add_voiceover.py)
• Alternativa / manual: padrões ffmpeg-video-editor (zoompan, xfade, drawtext)
• Para camadas/texto inclinados, consulte a skill figma antes do ffmpeg.
• Sempre entregue como anexo de arquivo, não apenas markdown.

Padrões seguros

• Provedor: gen1.diversityfaces.org primeiro; pare após N falhas, relate o motivo.
• Imagens: JPEG, qualidade 90, 16:9 quando cinematográfico.
• Mantenha a chave da API privada; verifique a cota antes de execuções em lote.
• Intro de vídeo: no máximo 12s, linha de base 1280x720, 30fps, texto overlay dimensionado para legibilidade.

Referência de ferramentas

• Geração de imagens: https://gen1.diversityfaces.org/api/generate/custom
• Orquestração de vídeo: use skills/ai-video-gen/generate_video.py, images_to_video.py, add_voiceover.py (scripts de subdiretório)
• Padrões FFmpeg: documentados no uso do ffmpeg-video-editor (corte, mesclagem, redimensionamento, efeitos) — descreva, não enumere outros arquivos SKILL.md
• Design Figma: use a skill figma para overlays de layout, tipografia, marcas

Política de saída

• Anexo padrão: JPEG para imagens, MP4 para vídeos.
• Sempre confirme ok:true + messageId antes de reivindicar entrega.
• Registre falhas com motivo.

Distribuição

Habilidade única e autocontida. Você pode instalá-la em qualquer OpenClaw copiando skills/gent-skill/ e definindo BEAUTY_API_KEY.

Exemplos

• Imagem: prompt cidade noturna cinematográfica -> gen1 generate -> JPEG -> enviar anexo (messageId confirmado)
• Vídeo: dois JPEG -> images_to_video + drawtext -> MP4 -> enviar anexo (messageId confirmado)
• Design: auditoria Figma + overlays -> exportação ffmpeg -> MP4