/code-motion-director
┌──────────────────────────────────────┐
│ 🔴 🟡 🟢 src/auth/session.ts [9:16]│ barra de título do Mac com caminho do arquivo
├──────────────────────────────────────┤
│ 01 async function verifyToken(jwt) { │
│ 02 const decoded = await verify(); │ linha ativa com foco
│ 03 if (!decoded.valid) { ┌─────┼─ 01 Validação de token
│ 04 throw new AuthError(); │ │
│ 05 } │ linhas inativas esmaecidas
│ 06 return decoded.user; │
├──────────────────────────────────────┤
│ > EXECUÇÃO NO TERMINAL │ gaveta deslizante do terminal
│ > POST /api/v1/auth/verify HTTP/1.1 │ registro animado de stdout
│ > Status: 200 OK (14.2ms) │
└──────────────────────────────────────┘
Primeiro Uso
O diretório desta skill é o diretório base do pacote da skill.
# Verifique se o Python 3 está instalado
python3 --version || python --version
Funciona de forma independente, sem chaves de API externas, dependências pesadas ou APIs de nuvem pagas. Usa HTML5 Canvas / SVG headless com Playwright, Puppeteer ou ffmpeg opcionais para renderização de MP4 headless.
Passos de Execução do Agente
- Código e Roteiro: Pergunte ao usuário pelo trecho de código ou extraia-o da solicitação. Identifique a narrativa principal:
- Qual linguagem? (JavaScript, TypeScript, Python, Rust, Go, SQL, Bash, HTML/CSS).
- Qual é o ponto focal? (por exemplo, uma chamada async await, um decorator, um lançamento de erro, um retorno recursivo).
- Qual saída do terminal ou resultado de execução prova que funciona?
- Criação da Especificação: Escreva
<nome>.code.json(especificação detalhada abaixo) no diretório de trabalho. - Construção e Renderização: Execute o script de construção:
python build.py <nome>.code.json- Para reprodução HTML interativa imediata, abra o arquivo
<nome>.motion.htmlgerado. - Para inspecionar um frame estático:
python build.py <nome>.code.json --snap 4.5. - Para validar a sintaxe do esquema:
python build.py <nome>.code.json --validate.
- Para reprodução HTML interativa imediata, abra o arquivo
- Verificação de Qualidade:
- As linhas de código cabem confortavelmente sem transbordamento horizontal (máximo de 48 caracteres por linha recomendado para 9:16 mobile; máximo de 80 para 16:9).
- As chamadas são concisas, numeradas de 01 a 03 e apontam claramente para as linhas de destino.
- A saída do terminal reflete com precisão o comportamento real de execução.
- Entrega: Entregue o caminho do HTML / vídeo renderizado e um resumo da especificação ao usuário.
Formato da Especificação (<nome>.code.json)
{
"title": "src/auth/session.ts",
"language": "typescript",
"aspectRatio": "9:16",
"theme": "obsidian",
"code": [
"async function verifyToken(token: string) {",
" const session = await auth.verify(token);",
" if (!session.isValid) {",
" throw new UnauthorizedError('Expired');",
" }",
" return session.user;",
"}"
],
"focusLines": [2, 3],
"typingSpeed": 35,
"callouts": [
{
"line": 2,
"label": "Verificação Assíncrona",
"note": "Aguarda assinatura criptográfica",
"side": "right"
},
{
"line": 4,
"label": "Cláusula de Guarda",
"note": "Rejeita payloads JWT expirados",
"side": "right"
}
],
"terminal": {
"enabled": true,
"title": "Saída do Servidor (Node.js v22)",
"commands": [
"$ curl -X POST https://api.dev/auth/verify",
"> Verificando assinatura HMAC-SHA256...",
"> Token Verificado: user_id=4092 [200 OK]"
]
},
"sound": {
"typewriterClicks": true,
"completionChime": true
},
"durationSeconds": 8.0
}
Definições dos Parâmetros
title: String exibida na barra de cabeçalho da janela (por exemplo, nome do arquivo ou caminho do módulo).language:"javascript","typescript","python","rust","go","sql","bash".aspectRatio:"9:16"(Reel vertical para TikTok/Shorts/Instagram) ou"16:9"(Widescreen horizontal).theme:"obsidian"(violeta escuro profundo),"onedark"(inspirado no Atom),"monokai"(alto contraste clássico) ou"cyberpunk"(ciano/magenta neon).code: Array de strings, cada uma representando uma linha de código.focusLines: Array de números de linha baseados em 1 para manter 100% de brilho enquanto outras linhas são esmaecidas.callouts: Lista opcional de anotações. Recomendado no máximo 3 chamadas.line: Número de linha baseado em 1 para ancorar a linha de chamada.label: Título curto em maiúsculas ou negrito (máx. 18 caracteres).note: Subtítulo explicativo (máx. 28 caracteres).
terminal: Gaveta inferior opcional com comandos e respostas stdout.sound: Configurações opcionais de síntese procedural da Web Audio API (cliques de digitação e som de conclusão).durationSeconds: Duração total da animação (padrão: 8.0s).
Plataformas Suportadas
| Plataforma | Método de Integração |
|---|---|
| Claude / Claude Code | Carregado via SKILL.md em ~/.claude/skills/code-motion-director/ ou workspace .claude-plugin/ |
| Google Antigravity | Registrado em .gemini/antigravity/skills/code-motion-director/ |
| ChatGPT / Custom GPTs | Configurado via Instruções Personalizadas usando adapters/chatgpt-instructions.md |
| Google Gemini | Injetado via instrução do sistema usando adapters/antigravity-gemini.md |
Padrões de Estilo e Estética
- Hierarquia visual clara: Mantenha o código limpo, formatado e legível. Nunca cole código minificado.
- Chamadas concisas: As notas das chamadas devem ser fatos técnicos, não propaganda de marketing ("Aguarda promessa", não "Recurso super legal!").
- Contraste e Legibilidade: Sempre garanta que a fonte do código seja suficientemente grande para telas de smartphones (mínimo de 28px em canvas 1080x1920).
- Ritmo: A digitação deve parecer natural (25–40ms por caractere). A saída do terminal deve aparecer após o término da digitação do código.