Communitygithub.com

evalix098/tiktoklive

Cartes de partage, favicon et icônes PWA pour les applications déployées sur *.grok.me. Génère automatiquement les métadonnées Open Graph, Twitter Card et les assets de marque pour le partage social et l'installabilité.

Qu'est-ce que tiktoklive ?

Cette compétence automatise la création et la gestion des assets de marque pour les applications déployées sur le domaine *.grok.me. Elle gère la carte de partage 1200×630 (og:image), le favicon SVG, les icônes PWA et la bannière X pour les jeux. L'utilisateur n'a qu'à fournir un nom et une palette de couleurs ; un sous-agent dédié (brand-asset pass) écrit tous les fichiers nécessaires dans `public/` et `src/lib/og/site.json`. Elle est déclenchée par des mots-clés comme "share", "OG", "twitter card", "favicon" ou "PWA". La compétence supporte les applications de tous types : jeux (Canvas/WebGL ou DOM), apps créatives, outils utilitaires. Pour les jeux, elle utilise le type `x:game` et génère une bannière X. Les applications purement utilitaires conservent le placeholder par défaut. Le sous-agent est toujours lancé sans attendre sa complétion, pour éviter des latences de génération devant l'utilisateur.

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

Demander à votre IA préférée

Ouvre une nouvelle conversation avec cette compétence d'agent déjà préchargée.

Documentation

Cartes de partage, favicon et icônes d'application

Une application déployée (https://{nom}.grok.me) se dévoile avec une carte 1200×630 ; chaque application (y compris l'aperçu) affiche un favicon dans l'onglet. Les balises <meta> de la carte de partage ne sont pas écrites dans __root.tsx — l'injecteur (scripts/grok-pwa-shared.mjs) écrase og:* et twitter:card à chaque réponse HTML. Les données d'identité sont la seule chose que quiconque écrit, et le passage écrit tout — en dispatchant, vous n'en initialisez rien :

  • src/lib/og/site.json — non pré-initialisé, créé seulement si nécessaire : { "title", "type"?: "x:game", "card"?: "custom", "color"?: "RRGGBB" } ; le titre par défaut est le slug de l'hôte.
  • public/og.jpg — carte personnalisée 1200×630 (optionnelle ; sinon placeholder)
  • public/x-banner.jpg — jeux uniquement : 50:11 (1200×264) carte de flux X
  • public/favicon.svg — liée depuis le head() racine ; tant que le passage n'a pas atterri, l'onglet montre juste le navigateur par défaut, ce qui n'échoue rien

Étendez __root.tsx ; ne le remplacez jamais en bloc (SSR d'auth, redesigns, extraits de compétence) : supprimer le lien favicon envoie une icône d'onglet vierge qu'aucune vérification locale ne détecte.

Décider : quelle carte cette application obtient

Par défaut : une carte personnalisée à partir de l'art de l'application elle-même — jeux de toutes sortes et technologies de rendu (Canvas/WebGL et plateau DOM, cartes, mots, puzzles, quiz : une grille de morpion en divs est toujours un jeu), applications fantaisistes, outils créatifs, pages axées contenu et marque. En cas de doute, créez la carte personnalisée.

Applications utilitaires simples uniquement (convertisseurs, traceurs CRUD, tableaux de bord, notes/admin — applications dont le visage sont les données) conservent le placeholder par défaut de og.grok.me : pas de public/og.jpg. Son URL, le réglage "color" et la règle de renommage : references/placeholder-card.md.

og:type pour les jeux

Un jeu de toute nature porte "type": "x:game" dans src/lib/og/site.json — le passage l'écrit, possédant ce fichier. Pas de nom d'hôte, jamais conditionné à une carte personnalisée, jamais "corrigé" en website, game nu, twitter:card ou un x:type inventé : le pipeline de X se base sur cette valeur exacte. Les non-jeux l'omettent. Votre vérification, pas votre édition — l'omettre, ou omettre public/x-banner.jpg une fois qu'une carte personnalisée existe, est un AVERTISSEMENT DE MARQUE.

Passage des assets de marque : toujours un sous-agent, jamais attendu

Avez-vous l'outil task ? Dispatchez ce passage en tant que sous-agent et ne générez jamais l'art de la carte vous-même — l'inline met des minutes de latence de génération devant l'utilisateur. Dès que le nom et la palette sont fixés (AGENTS.md § "Travail parallèle"), dispatchez cette invite textuellement. Elle est complète — n'ouvrez pas les références ci-dessous pour l'enrichir ; le passage les lit lui-même :

Vous êtes le passage des assets de marque. Suivez la compétence og, qui vous indique par où commencer. Application <NOM>, og:type <TYPE>, palette <PALETTE>. Vous possédez uniquement les assets de marque public/ et src/lib/og/site.json.

Continuez à construire. Restez séquentiel uniquement si l'utilisateur dirige l'art ou si l'art à réutiliser n'existe pas encore.

Ne l'attendez jamais. Pas de wait_tasks, et ne faites jamais get_task_output sur la tâche de marque : lire la sortie d'une tâche la consomme, et une tâche consommée n'envoie aucune notification de complétion, donc le résultat de la carte — y compris un échec — n'atteindrait personne. Répondez dès que l'application s'affiche ; le passage vous réveille plus tard, et ce tour est au maximum une phrase courte — une qui demande une republication, puisque public/og.jpg est livré dans la construction et qu'une carte qui atterrit après une publication n'atteint jamais l'application en ligne seule : "Carte de partage ajoutée — republiez si vous l'avez déjà fait." / "La carte a échoué ; la carte par défaut reste en place."

Pendant que le passage maintient /workspace/.grok/og-pending à jour, les vérifications de marque ne disent rien sur la carte : en vol n'est pas un constat. Le marqueur devient obsolète après 10 minutes, donc un passage très long laisse passer l'avertissement — mais un avertissement de marque pendant son exécution n'est jamais un signal pour refaire son travail.

Pas d'outil task ? Alors vous êtes le passage — construisez les assets maintenant ; rien d'autre ne le fera. Celui qui l'exécute réclame ce marqueur, met les fichiers en scène sous /workspace/.grok/ — jamais dans public/, que vite build copie textuellement dans l'application déployée — les remet avec scripts/write-atomic.mjs pour qu'aucune construction ne lise un demi-JPEG, et s'auto-vérifie avec node scripts/brand-check.mjs --game.

Construire les assets — le passage les lit, le parent ne le fait pas

En dispatchant ? Ne les ouvrez pas — l'invite ci-dessus est complète. Une lecture porte cette procédure dans votre contexte pour chaque tour ultérieur pendant que le sous-agent fait le travail de toute façon.

Vous êtes le passage ? Commencez par references/brand-pass.md, puis lisez par asset que vous devez : references/custom-card.md pour public/og.jpg, references/x-banner.md pour la bannière X réservée aux jeux public/x-banner.jpg, references/favicon-and-icons.md pour public/favicon.svg plus les icônes raster PWA — celles-ci uniquement lorsque l'utilisateur a demandé installable/PWA, n'inventez jamais un manifeste. Rédigez ce SVG à la main, jamais imagine_text_to_image : il doit rester net à 16px. Écrire site.json pour un jeu ? references/og-type-contract.md explique les orthographes que X rejette.

Régénérez lors d'un renommage ou d'un changement d'identité matériel — APP_NAME, le title de site.json et le titre de carte intégré bougent ensemble. Sans imagine_text_to_image ou l'API xAI Images, conservez la carte og.grok.me ; n'envoyez jamais une URL og:image cassée.

Non pris en charge

Pas de route /api/og, pas de rendu d'image runtime, pas de cartes par route — la carte est une image statique à l'échelle du site (public/og.jpg ou le service de placeholder). Si vous ajoutez robots.txt, jamais de Disallow: / général : les robots doivent récupérer / pour lire les balises.

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 associés