Preâmbulo (executar primeiro)
_TEL_TIER=$(cat ~/.superstack/config.json 2>/dev/null | grep -o '"telemetryTier": *"[^"]*"' | head -1 | sed 's/.*"telemetryTier": *"//;s/"$//' || echo "anonymous")
_TEL_TIER="${_TEL_TIER:-anonymous}"
_TEL_PROMPTED=$([ -f ~/.superstack/.telemetry-prompted ] && echo "yes" || echo "no")
_TEL_START=$(date +%s)
_SESSION_ID="$$-$(date +%s)"
mkdir -p ~/.superstack
echo "TELEMETRIA: $_TEL_TIER"
echo "TEL_PROMPTED: $_TEL_PROMPTED"
if [ "$_TEL_TIER" != "off" ]; then
_TEL_EVENT='{"skill":"video-craft","phase":"launch","event":"started","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'"}'
echo "$_TEL_EVENT" >> ~/.superstack/telemetry.jsonl 2>/dev/null || true
_CONVEX_URL=$(cat ~/.superstack/config.json 2>/dev/null | grep -o '"convexUrl":"[^"]*"' | head -1 | cut -d'"' -f4 || echo "")
[ -n "$_CONVEX_URL" ] && curl -s -X POST "$_CONVEX_URL/api/mutation" -H "Content-Type: application/json" -d '{"path":"telemetry:track","args":{"skill":"video-craft","phase":"launch","status":"success","version":"0.2.0","platform":"'$(uname -s)-$(uname -m)'","timestamp":'$(date +%s)000'}}' >/dev/null 2>&1 &
true
fi
Se TEL_PROMPTED for no: Antes de iniciar o fluxo de trabalho da skill, pergunte ao usuário sobre telemetria. Opções: A) Claro (anônimo) B) Não, obrigado. Isso acontece apenas uma vez.
Skill errada? Veja SKILL_ROUTER.md para todas as skills disponíveis.
Video Craft
Composição visual em nível de quadro e apresentação de demonstração de produto para vídeos Remotion. Esta skill faz com que cada quadro de um vídeo pareça intencionalmente projetado, e não apenas corretamente animado.
marketing-video lida com o pipeline de produção (entrevista, narrativa, mecânicas de animação, renderização). Esta skill lida com a aparência de cada quadro estático — composição, molduras de dispositivos, fundos, escolhas de efeitos e design de cartão final.
Modelo de Autoridade
marketing-video→ pipeline de produção, mecânicas de animação, qualidade de base (mínimos de tipo, zonas seguras, física de mola)design-taste→ direção estética. Esta skill CONSOOME, não redefine.- Esta skill → composição de quadros para visualização limitada no tempo, apresentação de demonstração de produto, design de cartão final, famílias de efeitos
Herda (NÃO reafirma): mínimos de tipo, zonas seguras móveis, legibilidade de texto, padrões de mola de marketing-video. Restrição de cor, assimetria, espaço em branco de design-taste.
Quando Acionar
- Revisando composições Remotion quanto à qualidade visual
- Criando vídeos de demonstração de produto com capturas de tela
- Projetando cartões finais / quadros de CTA
- O usuário diz "os quadros do vídeo parecem genéricos" ou "deixe isso mais polido"
marketing-videoinvoca esta skill durante as fases de direção criativa ou de construção
NÃO acionar para "criar um vídeo" ou "vídeo de marketing" — estes vão para marketing-video.
Fluxo de Trabalho
- Verificar
design-tastepara direção estética (ou pedir ao usuário para escolher uma) - Identificar qual referência é relevante:
- Compor quadros de vídeo ou cartões finais → references/frame-composition.md
- Construir cenas de demonstração de produto → references/product-demo-patterns.md
- Produzir um resumo de quadro (frame brief) por cena
- Executar lista de verificação pré-renderização
Resumo de Quadro (por cena)
Cena: [nome]
Duração: [segundos / quadros]
Proporção: [16:9 / 9:16 / 1:1]
Ponto focal: [o que o olho vê primeiro]
Arquétipo: [hero / product / split / data / comparison / end-card]
Dispositivo: [laptop / phone / browser / none]
Recursos necessários: [caminho da captura de tela, logotipo, nomes de ícones]
Fundo: [gradiente radial + ruído / desfoque de captura de tela / mesh / sólido]
Família de efeitos: [glow / kinetic / liquid / audio-lock / depth / none]
Animação: [configuração de mola de entrada, quadros de espera, saída]
Lista de Verificação Pré-renderização
- Cada quadro tem um ponto focal claro
- Capturas de tela estão em molduras de dispositivos, não soltas
- Fundos têm profundidade (gradiente + ruído ou vinheta), não são sólidos planos
- Máximo de 8 palavras por bloco de texto na tela
- Tempo de espera >=
(contagem_palavras x 0.3) + 1segundos por quadro de texto - Cartão final tem no mínimo 3 segundos e apenas uma ação
- Famílias de efeitos limitadas a 1-2 por vídeo
- Direção estética escolhida antes de qualquer trabalho de quadro
Recursos
references/
- references/frame-composition.md — Arquétipos de quadro (16:9 e 9:16), legibilidade com tempo limitado, profundidade de fundo, famílias de efeitos, arquétipos de cartão final (clean/metric/action/loop)
- references/product-demo-patterns.md — Pronto para Remotion: molduras de dispositivos (laptop/phone/browser), coreografia de cursor, receitas de zoom, preparação de captura de tela, padrões de anotação
Referências entre skills
marketing-video— pipeline de produção, mecânicas de animação, regras de qualidade de basedesign-taste— direção estética consumida antes do trabalho de quadronumber-formatting— para quaisquer métricas exibidas nos quadros
Telemetria (executar por último)
_TEL_END=$(date +%s)
_TEL_DUR=$(( _TEL_END - ${_TEL_START:-$_TEL_END} ))
_TEL_TIER=$(cat ~/.superstack/config.json 2>/dev/null | grep -o '"telemetryTier": *"[^"]*"' | head -1 | sed 's/.*"telemetryTier": *"//;s/"$//' || echo "anonymous")
if [ "$_TEL_TIER" != "off" ]; then
echo '{"skill":"video-craft","phase":"launch","event":"completed","outcome":"OUTCOME","duration_s":"'"$_TEL_DUR"'","session":"'"$_SESSION_ID"'","ts":"'$(date -u +%Y-%m-%dT%H:%M:%SZ)'","platform":"'$(uname -s)-$(uname -m)'"}' >> ~/.superstack/telemetry.jsonl 2>/dev/null || true
true
fi
Substitua OUTCOME por success/error/abort com base no resultado do fluxo de trabalho.