Communitygithub.com

code-motion-director

Gera animações de código, vídeos explicativos e reproduções de execução em terminal para criadores técnicos, educadores e desenvolvedores. Possui digitação progressiva, realce de linhas focadas, chamadas de destaque e terminal animado com saída stdout. Use quando o usuário executar /code-motion ou pedir para animar código, criar uma reprodução de codificação, fazer um passo a passo de sintaxe ou visualizar execução de código.

O que é code-motion-director?

Esta skill permite transformar trechos de código em animações visuais sofisticadas, ideais para tutoriais, apresentações técnicas ou postagens em redes sociais. Ela gera automaticamente um arquivo HTML com efeitos de digitação tipo máquina de escrever, destaque inteligente de linhas focadas e chamadas laterais explicativas, além de um terminal simulado com saída de execução. O usuário fornece um código e uma narrativa; a skill cria um arquivo de especificação JSON e, usando um script Python, renderiza a animação completa. Suporta vários temas visuais, proporções de tela 9:16 (para Stories/Shorts) e 16:9 (para widescreen), e pode gerar vídeos MP4 com opções de áudio sintetizado. Funciona sem depender de APIs externas ou serviços pagos, exigindo apenas Python e, opcionalmente, Playwright ou Puppeteer para exportação em vídeo. É compatível com Claude, ChatGPT, Google Gemini e outras plataformas de agentes de IA.

Funciona com✓Claude Code~Codex CLI~Cursor✓Antigravity✓Gemini CLI
npx skills add https://github.com/ishtiyaq8811/code-motion-director/tree/HEAD

Perguntar na sua IA favorita

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

Documentação

/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

  1. 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?
  2. Criação da Especificação: Escreva <nome>.code.json (especificação detalhada abaixo) no diretório de trabalho.
  3. 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.html gerado.
    • 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.
  4. 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.
  5. 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

PlataformaMétodo de Integração
Claude / Claude CodeCarregado via SKILL.md em ~/.claude/skills/code-motion-director/ ou workspace .claude-plugin/
Google AntigravityRegistrado em .gemini/antigravity/skills/code-motion-director/
ChatGPT / Custom GPTsConfigurado via Instruções Personalizadas usando adapters/chatgpt-instructions.md
Google GeminiInjetado 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.

Habilidades Relacionadas