Communitygithub.com

evalix098/tiktoklive

Solo para Grok Build. Convierte una imagen de personaje 2D estático en sprites de animación densos mediante imagine_text_to_image base → imagine_image_to_video (6s/10s en el mismo lugar) → fotogramas ffmpeg → croma magenta → tiras/rejillas/GIFs muestreados densamente. Úsalo cuando el usuario quiera video a sprite, ciclos de corrida/caminata más suaves o poses intermedias más densas. Prefiere generate2dsprite para hojas de píxeles nítidas de producción. Se activa con 'video a sprite', 'imagine_image_to_video sprite', 'ciclo de caminata denso', 'animación de corrida suave desde video'.

¿Qué es tiktoklive?

Este skill permite convertir una imagen de personaje 2D estático en sprites de animación densos utilizando herramientas nativas de Grok Build. A diferencia de generate2dsprite, que produce hojas de píxeles nítidas y fijas, video2dsprite usa generación de video para crear poses intermedias más suaves, ideales para ciclos de locomoción como correr o caminar. El proceso consta de tres pasos: generar una imagen base con fondo magenta sólido mediante imagine_text_to_image, animarla en el mismo lugar con imagine_image_to_video, y luego extraer, limpiar con croma magenta y muestrear los fotogramas para producir tiras, rejillas y GIFs en resoluciones de 8, 16, 24 y 48 fotogramas. Está diseñado exclusivamente para Grok Build y no funciona en otros entornos como Codex o Claude. Aunque produce animaciones más suaves, sacrifica nitidez de píxeles y puede presentar deriva de identidad o bordes de croma, por lo que se recomienda para experimentación o cuando el usuario busca un estilo más orgánico, dejando generate2dsprite como opción predeterminada para hojas de producción.

Compatible con✓Claude Code✓Codex CLI~Cursor
npx skills add https://github.com/evalix098/tiktoklive/tree/HEAD/.grok/skills/video2dsprite

Preguntar en tu IA favorita

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

Documentación

Video2dsprite (solo para Grok Build)

Convierte una imagen de personaje 2D base en sprites de animación densos usando las herramientas nativas de video de Grok Build.

Entorno de App-builder / Grok

ElementoValor
Directorio del skill.grok/skills/video2dsprite/
Scriptspython3 .grok/skills/video2dsprite/scripts/video2dsprite.py …
Herramientas de videoimagine_image_to_video — animar una file_path base (verificar que exista)
Inspeccionarread_file sobre imágenes fijas/fotogramas; reportar rutas de videos
Dependenciasffmpeg + Pillow + numpy (preinstalados en la imagen de app-builder)
Directorio de salidaassets/sprites/video2dsprite/<nombre>/ en /workspace
Por defectoPrefiere generate2dsprite para héroes de producción; este es el camino de movimiento más denso
imagen base → imagine_image_to_video (movimiento en el lugar) → extraer fotogramas → croma clave → muestrear/normalizar → tira / rejilla / GIF

Restricción de plataforma (leer primero)

Entorno de ejecución¿Soportado?
Grok Build (xAI)Sí — requiere un generador de imágenes + una herramienta imagen→video
Codex / Claude / otros agentesNo — carecen de las herramientas de video de Grok. Indica al usuario que este skill es solo para Grok Build y ofrece $generate2dsprite como alternativa

Evalúa por capacidad, no por el nombre exacto de la herramienta. La generación de imágenes aparece como imagine_text_to_image / imagine_image_to_image; el video como imagine_image_to_video o (heredado) generate_video. Usa el par que tenga tu lista de herramientas. Detente y explica solo cuando no tengas ninguna herramienta imagen→video. No simules movimiento con fotogramas dibujados por código.

Este skill es un camino opcional de movimiento más denso. No reemplaza $generate2dsprite:

Usa $generate2dsprite cuando…Usa $video2dsprite cuando…
Hojas de píxeles nítidas, rejillas fijas, héroes con identidad críticaEl usuario desea poses intermedias más densas / bucles con sensación más suave
Hojas de cuerpo para ataque/lanzamiento, paquetes de props, atlas de motorExperimentar con movimiento corrido/caminado/quieto obtenido de video
Predeterminado de producción para la mayoría de sprites de juegosEl usuario pide explícitamente video → fotogramas → sprites

El video suaviza los píxeles, desvía la identidad y deja bordes de croma. Siempre realiza control de calidad; para héroes de producción, prefiere $generate2dsprite a menos que el usuario quiera el aspecto de video.

Parámetros

Deducir de la solicitud del usuario:

  • subject: descripción del personaje / criatura, o ruta a una imagen fija existente
  • action: run | walk | idle | attack | frase de movimiento personalizada
  • view: normalmente side (desplazamiento lateral). topdown es más difícil: advierte y mantén la cámara fija
  • duration: 6 (predeterminado) o 10 segundos
  • frame_counts: qué conjuntos densos exportar, predeterminado 8,16,24,48
  • cell_size: tamaño de celda del sprite de salida, predeterminado 128
  • anchor: feet (predeterminado para locomoción lateral) | center
  • bg: #FF00FF sólido (requerido para croma)
  • name: slug de salida
  • out_dir: carpeta de trabajo (predeterminado ./sprites/video2dsprite/<nombre>/ o relativo al proyecto)

Reglas del agente

  1. Solo Grok. Rechazar en entornos de ejecución que no sean Grok con una breve explicación + alternativa $generate2dsprite.
  2. Imagen fija → video, nunca texto a video solo. Preparar el fotograma 1 como una imagen fija limpia con imagine_text_to_image (desde un prompt, o desde una file_path de referencia). Luego llamar a imagine_image_to_video con esa file_path de la imagen fija.
  3. Movimiento en el lugar. Indicar en el prompt correr/caminar en el lugar mirando en una dirección fija. Sin panorámica de cámara, sin desplazamiento de fondo, sin cambio de escena. El sujeto permanece aproximadamente centrado.
  4. Fondo magenta sólido en la imagen base y conservado en el prompt de video (#FF00FF / magenta puro). Requerido para el croma de relleno por inundación.
  5. No inventar arte con PIL/Canvas. El arte base proviene de imagine_text_to_image o de una imagen fija del usuario/local. Los scripts solo hacen postprocesado.
  6. No colocar salidas experimentales en el juego a menos que el usuario pida integrarlas.
  7. Preferir un ciclo de locomoción para uso en juego. El muestreo denso en un clip de 6s con múltiples ciclos está bien para vistas previas; para hojas de motor, opcionalmente remuestrear un solo ciclo (12–16 fotogramas) después del control visual de calidad.
  8. Reportar rutas absolutas del video, fotogramas limpios, tiras y GIFs de vista previa al finalizar.

Flujo de trabajo

1. Planificar

Elegir el conjunto mínimo útil:

  • Bucle de corrida/caminata en vista lateral → este skill
  • Kit de héroe con múltiples acciones → aún usar $generate2dsprite por acción; usar video solo para locomoción si se solicita
  • Paquetes de FX / proyectiles / props → $generate2dsprite, no video

Crear:

<out_dir>/
  base/
  video/
  frames-raw/
  frames-clean/
  sprite/          # conjunto predeterminado de 8 fotogramas + más denso x16/x24/x48
  prompt-used.txt
  pipeline-meta.json
  README.txt

2. Construir la imagen fija base

Opciones:

  • A. Sprite existente: leer la imagen, componer sobre fondo #FF00FF sólido si es necesario, luego pasar esa ruta del sandbox a imagine_image_to_image / imagine_image_to_video
  • B. Nuevo personaje: imagine_text_to_image con fondo magenta sólido, cuerpo completo, vista lateral, centrado
  • C. Coincidir referencia: imagine_image_to_image con la file_path de referencia, moviéndolo a magenta y preservando la identidad

Requisitos base:

  • Cuerpo completo visible, margen magenta generoso
  • Vista lateral para correr/caminar (perfil o 3/4 lateral), pies cerca del tercio inferior
  • Mismo estilo artístico que el resto del proyecto cuando exista una referencia
  • Sin texto, interfaz de usuario, marca de agua ni segundo personaje

Copiar la file_path devuelta y guardar como <out_dir>/base/<nombre>-base.png; conservar la file_path base para la llamada de video.

Escribir el prompt exacto de la imagen en prompt-used.txt.

3. Animar con imagine_image_to_video

Llamar a Grok imagine_image_to_video:

  • ruta de origen: <file_path de la imagen fija base> (ruta del sandbox devuelta por T2I / I2I)
  • duration: 6 (predeterminado) o 10
  • resolution_name: 480p a menos que el usuario pida 720p
  • prompt: un plano corto en presente (ver references/prompt-rules.md)

Restricciones de movimiento obligatorias en el prompt:

  • El sujeto corre/camina en el lugar (estilo cinta de correr)
  • Cámara fija — sin panorámica, zoom ni órbita
  • El fondo permanece magenta sólido plano
  • Identidad, vestimenta, paleta estables para todo el plano
  • Solo una acción continua única

Copiar la file_path del video devuelto a <out_dir>/video/<nombre>-<duración>s.mp4.

Si las herramientas de video no están disponibles, detenerse (restricción de plataforma).

4. Extraer + croma + muestrear (script local)

Ejecutar el procesador (ffmpeg + Pillow + numpy):

python3 .grok/skills/video2dsprite/scripts/video2dsprite.py process \
  --video <out_dir>/video/<nombre>-6s.mp4 \
  --out-dir <out_dir> \
  --name <nombre> \
  --frame-counts 8,16,24,48 \
  --cell-size 128 \
  --body-height 100 \
  --foot-y 118 \
  --fps 0

Notas:

  • --fps 0 = extraer cada fotograma decodificado (usar fps de origen)
  • Relleno por inundación magenta desde las esquinas + despill
  • Muestreo uniforme para cada cantidad en --frame-counts
  • Celdas normalizadas por pies, tira horizontal, rejilla, GIF de bucle por cantidad

Opcional: solo remuestrear conjuntos más densos desde fotogramas limpios existentes:

python3 .grok/skills/video2dsprite/scripts/video2dsprite.py sample \
  --clean-dir <out_dir>/frames-clean \
  --out-dir <out_dir> \
  --frame-counts 16,24,48 \
  --cell-size 128

5. Control de calidad

Verificar visualmente:

  • Los GIFs de vista previa en bucle no tienen saltos grandes
  • El magenta ha desaparecido (sin bloques rosas sólidos); se aceptan bordes o rehacer croma
  • Los pies se mantienen en una línea base estable (sin saltos por mal recorte)
  • La identidad es aproximadamente estable (cara/ropa no se transforman en cada fotograma)
  • La acción es en el lugar (no se desliza fuera del fotograma)
  • Para uso en juego: elegir una cantidad (a menudo 16 o 24) o recortar un ciclo verdadero

Si la identidad se desvía mucho o los píxeles son demasiado suaves, recurrir a $generate2dsprite para hojas de producción y conservar el conjunto de video solo como referencia de movimiento.

6. Entregar

Reportar solo las rutas (a menos que el usuario pida integrar en un juego):

  • Video: video/*.mp4
  • Sprites densos: sprite/x16|x24|x48/
  • Tiras / rejillas / GIFs: sprite/run-strip-N.png, run-grid-N.png, run-preview-N.gif
  • Meta: pipeline-meta.json

No modificar el código del juego a menos que se solicite.

Valores predeterminados

  • Duración: 6s
  • Acción: correr en el lugar en vista lateral, mirando a la derecha
  • Cantidades de exportación: 8, 16, 24, 48
  • Celda: 128², altura del cuerpo ~100, pies en y≈118
  • Fondo: #FF00FF
  • Preferir imagine_image_to_video de un solo activo sobre múltiples referencias (componer múltiples referencias con imagine_text_to_image primero si es necesario)

Compensaciones (informar al usuario una vez)

Ventajas: intermedios más densos → a menudo se siente más suave que 4–8 poses generadas discretas. Desventajas: píxeles más suaves, deriva de identidad, bordes de croma, clips de 6s con múltiples ciclos no son un solo bucle perfecto, activos más pesados. Regla general: 8→16→24 generalmente gana suavidad; 48 a menudo tiene rendimientos decrecientes; 145 fotogramas brutos son para muestrear, no todos para tiempo de ejecución.

Recursos

Relación con otros skills

  • $generate2dsprite — pipeline principal de hojas (Codex + Grok cuando existe generación de imágenes)
  • $generate2dmap — mapas; no se usa aquí
  • $video2dsprite — exclusivo de Grok Build ruta de densificación de movimiento
  • $game-asset-core / $game-animation-frames — bucles/prueba de volteo/leyes de movimiento y valores predeterminados listos para motor; aún usar los scripts de este skill para ejecución en sandbox (base magenta + croma), no un color de fondo libre

Individual skills in this repo

This repo contains 17 individual skills — each has its own dedicated page.

evalix098/tiktoklive

Add user accounts and sign-in to this TanStack Start app. Use when the app needs authentication, sign-in, user accounts, protected routes, or per-user data. Triggers on "auth", "login", "log in", "sign in", "sign up", "account", "users", "authentication", "protected", "who is logged in", "current user", "per-user".

evalix098/tiktoklive

Build browser games and interactive/canvas/3D experiences in this TanStack Start + React app. Use for any game, simulation, or WebGL/Canvas experience — 2D or 3D, single-player. Covers the game loop & timing, 3D orientation/camera conventions, collision, performance, assets, audio, save, game feel, and per-genre playbooks. For WASD / vehicle / flight **input signs and inverted A/D**, open the **`controls`** skill — do not rely on this file or racing-kart alone. Triggers on "game", "minecraft", "fps", "platformer", "racing", "tetris", "snake", "shooter", "3d", "three.js", "canvas", "voxel", "physics".

evalix098/tiktoklive

Player-facing input signs for browser games: WASD, vehicles, flight, FPS mouse-look, and the #1 failure mode (inverted A/D). Mandatory control self-tests and a tiny test interface so you can verify A turns left before shipping. Load for ANY game with movement, steering, flying, driving, tanks, boats, mechs, drones, planes, karts, third-person follow cams — not only racing. Triggers on "controls", "WASD", "inverted", "steer", "flight", "airplane", "kart", "vehicle", "yaw", "roll", "pitch", "mouse look", "A/D".

evalix098/tiktoklive

Design and build polished, non-generic UI for this TanStack Start + React + Tailwind v4 + shadcn/Radix app. Use whenever you create or restyle any interface surface — pages, landing pages, dashboards, forms, modals, nav, and game overlays (start screens, HUD, menus). Covers design tokens, layout, typography, color, spacing, motion, and the anti-"AI-slop" rules that keep output from looking generic. Triggers on "design", "UI", "make it look good", "polish", "landing page", "theme", "style", "redesign", "ugly", "clean up".

evalix098/tiktoklive

Deep guide for game ANIMATION assets: motion cycles, action keyframes, effect sequences, and animation sprite sheets — built around a video-first pipeline. In this app-builder sandbox, execute via the video2dsprite / generate2dsprite skills (magenta + scripts), not ad-hoc ffmpeg. Use whenever generating anything that moves: walk/run cycles, attacks, idles, FX, flags, fire, animation sheets. Complements game-asset-core.

evalix098/tiktoklive

Core discipline for ANY game-asset generation with Imagine tools: the engine-ready defaults users don't state, spec checklists, style anchoring, read-back verification, honest defect flagging. Use whenever generating any game art (sprites, sheets, animations, tiles, UI, FX) — then ALSO load the matching specialist skill: game-animation-frames for anything that moves, game-tilesets for tiles/terrain, game-character-consistency for recurring characters, game-ui-icons for UI and icons.

evalix098/tiktoklive

Deep guide for CHARACTER IDENTITY across images: turnarounds (front/side/ back), state and damage variants, palette swaps, equipment changes, and same-character-in-context sets. Use whenever generating character turnarounds, character sheets, variants of an existing sprite, or any same-subject multi-image set. Complements game-asset-core.

evalix098/tiktoklive

Deep guide for game TILE assets: seamless tileable textures, terrain transition tilesets, autotiles, and ground/platform tiles. Use whenever generating tileable textures, tilesets, terrain transitions, or seamless patterns. Complements game-asset-core.

evalix098/tiktoklive

Deep guide for game UI assets: buttons with interaction states, panels, bars, wordmark logos, and icon sets. Use whenever generating game UI elements, HUD assets, inventory icons, icon sets, buttons, or title logos. Complements game-asset-core.

evalix098/tiktoklive

Generate production-oriented 2D game maps with `imagine_text_to_image`: RPG/top-down maps, side-scroller parallax stages, tilemaps, layered raster maps, prop packs, collision zones, and walkable areas. Use when building browser games that need real map art (not pure code-drawn tiles), layered props, or map collision metadata. Triggers on "map", "level", "stage", "tilemap", "overworld", "dungeon", "side scroller background", "prop pack", "2D map".

evalix098/tiktoklive

Generate and postprocess 2D game sprites and animation sheets: pixel-art characters, NPCs, creatures, spells, projectiles, impacts, props, summons, and transparent PNG/GIF exports. Use when building browser games that need real sprite sheets (not code-drawn placeholders), matching a map art style, or producing magenta-background sheets for chroma-key cleanup. Triggers on "sprite", "sprite sheet", "animation sheet", "pixel art character", "walk cycle", "attack animation", "projectile sprite", "2D game asset".

evalix098/tiktoklive

How to use the Imagine tools in Grok Build: imagine_text_to_image, imagine_image_to_image, imagine_reference_to_image, imagine_text_to_video, imagine_image_to_video, imagine_reference_to_video, and render_file for chat previews. When to build a visual with code instead of generating it, prompt-craft, reference-first handling of real people, factual grounding, and asset-consistency. Load this whenever generating or editing an image or video is on the table. Tool-usage-driven, not triggered by a user merely mentioning images.

evalix098/tiktoklive

Peer-to-peer realtime multiplayer over WebRTC data channels: every user of the deployed app connects directly to every other user (full mesh), the server only brokers the handshake at /api/rtc. Lowest possible latency, zero per-message server cost. Use for 2-8 player co-op/casual realtime: shared cursors, drawing, party games, casual action. Triggers: p2p, peer to peer, webrtc, low latency multiplayer, direct connection.

evalix098/tiktoklive

Use Neon Postgres (the database) in this TanStack Start app. Use when the app needs to store or query data, persist state, or keep per-user data. Triggers on "database", "Postgres", "Neon", "save data", "store data", "persist", "tables", "SQL", "query", "migrations".

evalix098/tiktoklive

Share-link previews and app identity for apps on *.grok.me: the injector-owned og:image card, the SVG favicon, and PWA icons for installable apps. Use when scaffolding, renaming, or restyling the app — and for share / unfurl / OG / Twitter card questions. A custom 1200×630 card from the app's own art is the default — games of every kind (DOM board/word games included), whimsical apps, creative tools, and brand-forward pages; only plain utilities keep the placeholder. Always run the brand-asset pass as a `task` subagent and never wait for it. Triggers on "share", "rename", "app name", "OG", "Open Graph", "twitter card", "unfurl", "og:image", "og:type", "x:game:image", "x-banner", "link preview", "social card", "thumbnail", "preview image", "favicon", "app icon", "PWA", "manifest", "installable", "home screen", "SEO", "meta description".

evalix098/tiktoklive

Official Three.js API and TSL (Three.js Shading Language) reference for LLM code generation. Load when writing or debugging three.js / WebGL / WebGPU / custom materials / shaders / GLTF / advanced three APIs beyond basic game loop/controls. Prefer building-games for game correctness (loop, WASD, camera, orientation); use this skill for full API/TSL depth. Triggers on "three.js", "threejs", "WebGPU", "TSL", "NodeMaterial", "shader", "GLTF", "MeshStandard", "OrbitControls", "WebGLRenderer".

evalix098/tiktoklive

Call the xAI API (Grok) from this app's server code using the injected XAI_API_KEY: chat/LLM features, image and video generation (Imagine), and voice (text-to-speech). Use when the app needs any "AI" / "assistant" / "chatbot" / "Grok" functionality, runtime image/video generation, or speech. Triggers on "AI", "LLM", "chatbot", "assistant", "Grok", "xAI", "generate text", "summarize", "generate image", "AI video", "voice", "text to speech", "TTS", "OpenAI" (use xAI instead).

Skills relacionados