Communitygithub.com

director-de-movimiento-de-código

Genera tutoriales de sintaxis animados, videos explicativos de código y secuencias de ejecución en terminal para creadores técnicos, educadores y desarrolladores.

¿Qué es director-de-movimiento-de-código?

Esta habilidad para agentes de IA te permite crear presentaciones animadas de código fuente y ejecución en terminal. Es ideal para desarrolladores, educadores y creadores de contenido técnico que desean producir videos atractivos para plataformas como TikTok, YouTube Shorts o Instagram Reels. La habilidad se ejecuta de forma autónoma, sin necesidad de claves de API externas, dependencias pesadas o servicios en la nube de pago; utiliza Canvas/SVG sin interfaz gráfica y puede generar archivos MP4 con Playwright, Puppeteer o ffmpeg. Compatible con Claude, Google Gemini y ChatGPT, genera un archivo de especificación JSON que define el código, los focos visuales, las anotaciones y la salida del terminal, y luego lo renderiza como HTML interactivo o video. El resultado es una secuencia mecanografiada con resaltado de sintaxis, líneas de enfoque, llamadas numeradas y una ventana de terminal deslizante, todo personalizable en tema, relación de aspecto y velocidad de escritura.

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

Preguntar en tu IA favorita

Abre un nuevo chat con esta habilidad de agente ya precargada.

Documentación

/director-de-movimiento-de-código

┌──────────────────────────────────────┐
│ 🔴 🟡 🟢  src/auth/session.ts   [9:16]│  barra de título Mac con ruta de archivo
├──────────────────────────────────────┤
│ 01 async function verifyToken(jwt) { │
│ 02   const decoded = await verify(); │  línea activa enfocada
│ 03   if (!decoded.valid) {     ┌─────┼─ 01 Validación de token
│ 04     throw new AuthError();  │     │
│ 05   }                               │  líneas inactivas atenuadas
│ 06   return decoded.user;            │
├──────────────────────────────────────┤
│ > EJECUCIÓN EN TERMINAL               │  cajón deslizante de terminal
│ > POST /api/v1/auth/verify HTTP/1.1  │  registro animado de stdout
│ > Estado: 200 OK (14.2ms)            │
└──────────────────────────────────────┘

Primer uso

El directorio de esta habilidad es el directorio base del paquete de la habilidad.

# Verificar que Python 3 está instalado
python3 --version || python --version

Se ejecuta de forma independiente sin claves de API externas, dependencias pesadas ni API en la nube de pago. Utiliza Canvas / SVG sin interfaz gráfica con Playwright, Puppeteer o ffmpeg opcionales para renderizado de MP4 sin cabeza.


Pasos de ejecución del agente

  1. Código y guión: Pregunta al usuario por el fragmento de código o extráelo de su solicitud. Identifica la narrativa central:
    • ¿Qué lenguaje? (JavaScript, TypeScript, Python, Rust, Go, SQL, Bash, HTML/CSS).
    • ¿Cuál es el punto focal? (por ejemplo, una llamada async await, un decorador, un lanzamiento de error, un retorno recursivo).
    • ¿Qué salida de terminal o resultado de ejecución demuestra que funciona?
  2. Creación de especificación: Escribe <nombre>.code.json (especificación detallada a continuación) en el directorio de trabajo.
  3. Construcción y renderizado: Ejecuta el script de construcción:
    python build.py <nombre>.code.json
    
    • Para una reproducción HTML interactiva inmediata, abre el archivo <nombre>.motion.html generado.
    • Para inspeccionar una imagen fija: python build.py <nombre>.code.json --snap 4.5.
    • Para validar la sintaxis del esquema: python build.py <nombre>.code.json --validate.
  4. Control de calidad:
    • Las líneas de código caben cómodamente sin desbordamiento horizontal (máximo 48 caracteres por línea recomendado para 9:16 móvil; máximo 80 para 16:9).
    • Las llamadas son concisas, numeradas del 01 al 03, y apuntan claramente a las líneas objetivo.
    • La salida del terminal refleja con precisión un comportamiento de ejecución realista.
  5. Entrega: Entrega al usuario la ruta del HTML / video renderizado y el resumen de la especificación.

Formato de especificación (<nombre>.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": "Verificación Asíncrona",
      "note": "Espera la firma criptográfica",
      "side": "right"
    },
    {
      "line": 4,
      "label": "Cláusula de Guardia",
      "note": "Rechaza cargas JWT caducadas",
      "side": "right"
    }
  ],
  "terminal": {
    "enabled": true,
    "title": "Salida del Servidor (Node.js v22)",
    "commands": [
      "$ curl -X POST https://api.dev/auth/verify",
      "> Verificando firma HMAC-SHA256...",
      "> Token Verificado: user_id=4092 [200 OK]"
    ]
  },
  "sound": {
    "typewriterClicks": true,
    "completionChime": true
  },
  "durationSeconds": 8.0
}

Definiciones de Parámetros

  • title: Cadena mostrada en la barra de encabezado de la ventana (por ejemplo, nombre de archivo o ruta de módulo).
  • language: "javascript", "typescript", "python", "rust", "go", "sql", "bash".
  • aspectRatio: "9:16" (Reel vertical para TikTok/Shorts/Instagram) o "16:9" (Pantalla ancha horizontal).
  • theme: "obsidian" (violeta oscuro profundo), "onedark" (inspirado en Atom), "monokai" (clásico de alto contraste) o "cyberpunk" (cian/magenta neón).
  • code: Arreglo de cadenas, cada una representando una línea de código.
  • focusLines: Arreglo de números de línea basados en 1 para mantener al 100% de brillo mientras las otras líneas se atenúan.
  • callouts: Lista opcional de anotaciones. Se recomienda un máximo de 3 llamadas.
    • line: Número de línea basado en 1 para anclar la línea guía.
    • label: Encabezado corto en mayúsculas o negrita (máximo 18 caracteres).
    • note: Subtítulo explicativo (máximo 28 caracteres).
  • terminal: Cajón inferior opcional con comandos de stdout y respuestas.
  • sound: Configuración opcional de síntesis procedural de la Web Audio API (clics de escritura y campanilla).
  • durationSeconds: Duración total de la animación (por defecto: 8.0s).

Plataformas Compatibles

PlataformaMétodo de Integración
Claude / Claude CodeCargado vía SKILL.md en ~/.claude/skills/code-motion-director/ o en el workspace .claude-plugin/
Google AntigravityRegistrado bajo .gemini/antigravity/skills/code-motion-director/
ChatGPT / GPTs PersonalizadosConfigurado mediante Instrucciones Personalizadas usando adapters/chatgpt-instructions.md
Google GeminiInyectado vía instrucción del sistema usando adapters/antigravity-gemini.md

Estándares de Gusto y Estética

  • Jerarquía visual clara: Mantén el código limpio, formateado y legible. Nunca pegues código minificado.
  • Llamadas concisas: Las notas de las llamadas deben ser hechos técnicos, no exageraciones de marketing ("Espera la promesa", no "¡Característica súper genial!").
  • Contraste y legibilidad: Asegúrate siempre de que el tamaño de la fuente del código sea suficiente para pantallas de teléfonos móviles (mínimo 28px en un lienzo de 1080x1920).
  • Ritmo: La escritura debe sentirse natural (25–40ms por carácter). La salida del terminal debe aparecer después de que el código termine de escribirse.

Skills relacionados