Communitygithub.com

evalix098/tiktoklive

Vista previa de enlaces compartidos e identidad de aplicación para apps en *.grok.me: la tarjeta og:image propiedad del inyector, el favicon SVG y los iconos PWA para apps instalables.

¿Qué es tiktoklive?

Esta habilidad automatiza la configuración de metadatos de tarjetas de previsualización de enlaces (Open Graph, Twitter Card), favicons e iconos de aplicaciones web progresivas (PWA) para aplicaciones desplegadas en el dominio *.grok.me. Es especialmente útil para desarrolladores que utilizan plataformas de agente como Claude Code, Cursor o Codex para andamiar, renombrar o cambiar el estilo visual de sus apps. La habilidad maneja la inyección de etiquetas `<meta>` en cada respuesta HTML a través de un inyector (`scripts/grok-pwa-shared.mjs`), evitando que el desarrollador tenga que escribirlas manualmente. Decide automáticamente si la app merece una tarjeta personalizada (juegos, apps creativas, páginas de marca) o si debe mantener el marcador de posición por defecto (utilidades simples). Además, gestiona la generación de assets como `og.jpg`, `x-banner.jpg` y `favicon.svg`, y orquesta un paso de 'brand-asset pass' que se ejecuta como subagente en segundo plano, sin bloquear el flujo principal. También incluye reglas específicas para el tipo `og:type` en juegos y la generación de iconos rasterizados de PWA solo cuando se solicita explícitamente.

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

Preguntar en tu IA favorita

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

Documentación

Tarjetas de compartir, favicon e iconos de app

Una app desplegada (https://{nombre}.grok.me) se despliega con una tarjeta de 1200×630; cada app (incluyendo la vista previa) muestra un favicon en la pestaña. Las etiquetas <meta> de la tarjeta de compartir no se escriben en __root.tsx — el inyector (scripts/grok-pwa-shared.mjs) sobrescribe og:* y twitter:card en cada respuesta HTML. Los datos de identidad son lo único que alguien escribe, y el pase escribe todo eso — al despachar, no siembras nada de eso:

  • src/lib/og/site.json — no está pre-sembrado, se crea solo si es necesario: { "title", "type"?: "x:game", "card"?: "custom", "color"?: "RRGGBB" }; el título por defecto es el slug del host.
  • public/og.jpg — tarjeta personalizada de 1200×630 (opcional; si no, se usa el marcador de posición)
  • public/x-banner.jpg — solo para juegos: tarjeta de feed de X en proporción 50:11 (1200×264)
  • public/favicon.svg — enlazado desde el head() raíz; hasta que el pase lo coloque, la pestaña muestra el icono por defecto del navegador, lo cual no falla nada

Extiende __root.tsx; nunca lo reemplaces por completo (SSR de autenticación, rediseños, extractos de habilidades): eliminar el enlace al favicon envía un icono de pestaña en blanco que ninguna comprobación local detecta.

Decidir: qué tarjeta recibe esta app

Por defecto: una tarjeta personalizada a partir del arte propio de la app — juegos de todo tipo y tecnología de renderizado (Canvas/WebGL y tablero DOM, cartas, palabras, rompecabezas, trivia: una cuadrícula de tres en raya de divs sigue siendo un juego), apps caprichosas, herramientas creativas, páginas de contenido y de marca. En caso de duda, haz la tarjeta personalizada.

Solo las apps de utilidad simple (convertidores, rastreadores CRUD, paneles, notas/admin — apps cuya cara son los datos) mantienen el marcador de posición por defecto de og.grok.me: no hay public/og.jpg. Su URL, el knob "color" y la regla de renombrado: references/placeholder-card.md.

og:type para juegos

Un juego de cualquier tipo lleva "type": "x:game" en src/lib/og/site.json — el pase lo escribe, siendo el dueño de ese archivo. Sin nombre de host, nunca condicionado a una tarjeta personalizada, nunca "corregido" a website, game simple, twitter:card o un x:type inventado: la tubería de X depende de ese valor exacto. Las no-juegos lo omiten. Tu verificación, no tu edición — si falta, o si falta public/x-banner.jpg una vez que existe una tarjeta personalizada, es una ADVERTENCIA DE MARCA.

Pase de assets de marca: siempre un subagente, nunca se espera por él

¿Tienes la herramienta task? Despacha este pase como subagente y nunca generes el arte de la tarjeta tú mismo — hacerlo en línea pone minutos de latencia de generación frente al usuario. Tan pronto como el nombre y la paleta se estabilicen (AGENTS.md § "Trabajo paralelo"), despacha este mensaje textualmente. Está completo — no abras las referencias a continuación para enriquecerlo; el pase las lee por sí mismo:

Eres el pase de assets de marca. Sigue la habilidad og, que te dice por dónde empezar. App <NOMBRE>, og:type <TIPO>, paleta <PALETA>. Eres el único dueño de los assets de marca en public/ y de src/lib/og/site.json.

Sigue construyendo. Mantente secuencial solo si el usuario está dirigiendo el arte o el arte a reutilizar aún no existe.

Nunca esperes por él. No uses wait_tasks, y nunca uses get_task_output en la tarea de marca: leer la salida de una tarea la consume, y una tarea consumida no envía notificación de finalización, por lo que el resultado de la tarjeta — incluyendo un fallo — no llegaría a nadie. Responde tan pronto como la app se renderice; el pase te despierta más tarde, y ese turno es como máximo una oración corta — una que pida una republicación, ya que public/og.jpg se envía en la compilación y una tarjeta que llega después de una publicación nunca llega a la app en vivo por sí sola: "Se añadió la tarjeta de compartir — publica de nuevo si ya lo hiciste." / "La tarjeta falló; se queda la predeterminada."

Mientras el pase mantenga fresco /workspace/.grok/og-pending, las comprobaciones de marca no dicen nada sobre la tarjeta: en vuelo no es un hallazgo. El marcador se vuelve obsoleto después de 10 minutos, por lo que un pase muy largo deja pasar la advertencia — pero una advertencia de marca mientras se ejecuta nunca es una señal para rehacer su trabajo.

¿No tienes la herramienta task? Entonces tú eres el pase — construye los assets ahora; nadie más lo hará. Quien lo ejecute reclama ese marcador, prepara archivos bajo /workspace/.grok/ — nunca dentro de public/, que vite build copia textualmente en la app desplegada — los entrega con scripts/write-atomic.mjs para que ninguna compilación lea medio JPEG, y se auto-verifica con node scripts/brand-check.mjs --game.

Construir los assets — el pase lee esto, el padre no

¿Despachando? No los abras — el mensaje anterior está completo. Una lectura lleva este procedimiento en tu contexto en cada turno posterior mientras el subagente hace el trabajo de todas formas.

¿Eres el pase? Empieza en references/brand-pass.md, luego lee por cada asset que debes: references/custom-card.md para public/og.jpg, references/x-banner.md para el public/x-banner.jpg solo para juegos, references/favicon-and-icons.md para public/favicon.svg más los iconos rasterizados de PWA — esos solo cuando el usuario pidió instalable/PWA, nunca inventes un manifiesto. Escribe ese SVG a mano, nunca uses imagine_text_to_image: debe mantenerse nítido a 16px. ¿Escribiendo site.json para un juego? references/og-type-contract.md discute las grafías que X rechaza.

Regenera al renombrar o con un cambio material de identidad — APP_NAME, el title de site.json y el título de la tarjeta incrustada se mueven juntos. Sin imagine_text_to_image o la API de Imágenes de xAI, mantén la tarjeta de og.grok.me; nunca envies una URL de og:image rota.

No soportado

No hay ruta /api/og, ni renderizador de imágenes en tiempo de ejecución, ni tarjetas por ruta — la tarjeta es una imagen estática de todo el sitio (public/og.jpg o el servicio de marcador de posición). Si añades robots.txt, nunca uses un Disallow: / general: los rastreadores deben obtener / para leer las etiquetas.

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

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

Grok Build only. Turn a 2D character still into denser animation sprites via imagine_text_to_image base → imagine_image_to_video (6s/10s run-in-place) → ffmpeg frames → magenta chroma-key → dense sampled strips/grids/GIFs. Use when the user wants video-to-sprite, smoother run/walk cycles, or denser intermediate poses. Prefer generate2dsprite for crisp production pixel sheets. Triggers on "video to sprite", "imagine_image_to_video sprite", "dense walk cycle", "smooth run animation from video".

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