Communitygithub.com

evalix098/tiktoklive

Gere e pós-processe sprites 2D e folhas de animação para jogos de navegador: personagens pixel art, NPCs, criaturas, feitiços, projéteis, impactos, adereços, invocações e exportações PNG/GIF transparentes.

O que é tiktoklive?

Esta skill gera e pós-processa sprites 2D e folhas de animação para jogos de navegador, focando em arte pixel art e estilos relacionados. Ela é ideal para criar personagens, NPCs, criaturas, feitiços, projéteis, impactos, adereços e invocações, exportando como PNGs transparentes ou GIFs. A skill utiliza o sandbox app-builder (TanStack Start + jogos de navegador) e depende dos comandos `imagine_text_to_image` e `imagine_image_to_image` para gerar as imagens, seguido de scripts Python para pós-processamento como remoção de fundo magenta, divisão de quadros e exportação de folhas. Ela suporta vários parâmetros como tipo de ativo (player, npc, criatura, etc.), ação (idle, ataque, corrida, etc.), vista (topdown, lateral, 3/4), layout de folha, e estilo artístico. É especialmente útil para desenvolvedores que precisam de sprites reais em folhas, em vez de placeholders desenhados por código, e que desejam integrar com motores como Phaser, Canvas 2D ou DOM.

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

Perguntar na sua IA favorita

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

Documentação

Generate2dsprite

Use esta skill para ativos de sprite 2D ou animação autocontidos no sandbox app-builder (TanStack Start + jogos de navegador).

Quando um jogo maior ou protótipo jogável precisar de sprites, use esta skill para os ativos de sprite visíveis e mantenha a montagem do runtime/jogo separada (conecte ao Phaser / Canvas / DOM após a exportação). Não substitua ativos de sprite solicitados por placeholders desenhados com código.

Ambiente App-builder / Grok

ItemValor
Diretório da skill.grok/skills/generate2dsprite/
Scriptspython3 .grok/skills/generate2dsprite/scripts/<script>.py …
Ferramentas de imagemimagine_text_to_image / imagine_image_to_image (baseado em caminho; veja a skill imagine para criação de prompt)
Inspecionar imagensread_file no caminho do PNG (não Codex view_image)
Caminho da imagem geradaimagine_text_to_image retorna um file_path do sandbox; copie esse caminho para seu diretório de execução antes de processar
Dependências PythonPillow + numpy (pré-instalados na imagem)
Diretório de saídaPrefira assets/sprites/<nome>/ em /workspace para que o app possa importá-los
Alvo do motorNavegador: Canvas 2D, Phaser ou DOM/<img> — não Godot/Unity a menos que o usuário peça

Skills relacionadas: imagine (uso da ferramenta de imagem), game-asset-core (+ game-animation-frames / game-character-consistency para QC e padrões prontos para o motor), generate2dmap (mapas/props), video2dsprite (movimento mais denso via imagine_image_to_video), building-games (game loop / integração).

Parâmetros

Infira estes a partir da solicitação do usuário:

  • asset_type: player | npc | creature | character | spell | projectile | impact | prop | summon | fx
  • action: single | idle | cast | attack | shoot | jump | hurt | combat | walk | run | hover | charge | projectile | impact | explode | death
  • view: topdown | side | 3/4
  • sheet: auto | 2x2 | 2x3 | 2x4 | 3x3 | 3x4 | 4x4 | 5x5 | custom_grid | strip_1x3 | strip_1x4
  • frames: auto ou contagem explícita
  • bundle: single_asset | unit_bundle | spell_bundle | combat_bundle | line_bundle | hero_action_bundle | engine_atlas
  • effect_policy: all | largest
  • anchor: center | bottom | feet
  • margin: tight | normal | safe
  • art_style: pixel_art | clean_hd | pixel_inspired | retro_pixel | map_style | project-native
  • reference: none | attached_image | generated_image | local_file
  • layout_guide: none | optional | recommended
  • prompt: o tema ou direção visual do usuário
  • role: apenas quando o ativo for claramente um papel de NPC
  • name: slug de saída opcional

Leia references/modes.md quando a solicitação for ambígua.

Regras do Agente

  • Decida você mesmo o plano do ativo. Não force o usuário a especificar o tamanho da folha, contagem de quadros ou estrutura do pacote quando a solicitação já os implica.
  • Não empacote ações não relacionadas em uma única folha gerada bruta apenas para satisfazer um 4x4, 5x5 ou atlas de motor personalizado. Uma folha gerada bruta deve representar uma família de ações, uma sequência contínua, uma folha de locomoção direcional canônica ou um pacote de props/ativos.
  • Para heróis controláveis, personagens principais e ativos de jogador de alto valor com múltiplas ações, gere folhas de grade separadas por ação primeiro, faça o QC de cada ação, depois monte deterministicamente o atlas exigido pelo motor somente após as grades passarem pela revisão visual.
  • Para heróis controláveis, personagens principais e ações corporais de jogador de alto valor, defina as folhas corporais padrão de ataque/disparo/feitiço como apenas o corpo. Não inclua grandes arcos de corte, flashes de boca, projéteis, explosões de impacto, poeira destacada, rastros longos ou FX amplos destacados na folha do corpo. Gere-os como folhas separadas fx, projectile ou impact e coloque-as em camadas no jogo.
  • Inclua apenas FX de ataque amplo na mesma folha corporal bruta quando o runtime alvo suportar explicitamente células mais largas por ação mais metadados de origem/âncora por ação. Caso contrário, uma caixa delimitadora de FX ampla forçará o corpo a encolher dentro da célula fixa.
  • Escreva você mesmo o prompt de arte. Não use o script de criação de prompt como padrão.
  • Use o imagine_text_to_image integrado para cada imagem bruta.
  • Não crie arte de sprite bruta com Three.js, Canvas, SVG, desenho HTML/CSS, desenho de forma PIL, geometria procedural, placeholders primitivos ou capturas de tela renderizadas por código. O código de tempo de execução pode exibir ativos gerados finalizados, e scripts podem fazer guias de layout ou pós-processar imagens geradas, mas a arte de sprite solicitada deve ter origem no imagine_text_to_image integrado.
  • Quando o usuário fornecer ou implicar uma referência visual, passe o file_path do sandbox dessa referência para imagine_image_to_image (a ferramenta lê o arquivo). Também read_file a referência local para que você possa vê-la; um caminho mencionado apenas dentro do prompt não é uma entrada visual.
  • Não force pixel art quando o ativo for um prop de mapa para $generate2dmap ou quando o usuário/projeto solicitar um estilo diferente. Corresponda primeiro ao mapa ou ao estilo de referência.
  • Use o script apenas como um processador determinístico: limpeza magenta, divisão de quadros, filtragem de componentes, redimensionamento, alinhamento, metadados de QC, exportação de folha transparente e exportação de GIF.
  • Não use scripts para gerar o prompt de imagem criativo. Se um comando legado de criação de prompt existir, trate-o apenas como compatibilidade histórica, não como o fluxo de trabalho normal da skill.
  • Guias de layout são permitidos apenas como referências geométricas determinísticas para geração de imagem. Eles podem mostrar contagem de slots, espaçamento, centralização e preenchimento seguro, mas nunca devem definir a direção artística criativa.
  • Trate as flags de script como primitivas de execução escolhidas pelo agente, não fluxo de trabalho codificado voltado para o usuário.
  • Se uma folha gerada tocar as bordas das células, desviar na escala ou quebrar um loop de projétil/impacto, ou reprocesse com melhores configurações primitivas ou regenere a folha bruta.
  • Não use folhas brutas de linha única como 1x4, 1x6, 1x8 ou 1xN para personagens, jogadores, heróis controláveis, criaturas, NPCs, inimigos, invocações, props animados ou qualquer ativo onde um corpo/sujeito deva permanecer centralizado. A geração bruta de linha única é muito propensa a desviar horizontalmente e cortar de forma inconsistente.
  • Para ativos corporais animados, use uma grade de várias linhas por padrão: 4 quadros -> 2x2, 6 quadros -> 2x3, 8 quadros -> 2x4, 9 quadros -> 3x3, 12 quadros -> 3x4 ou 4x3, 16 quadros -> 4x4.
  • Se um motor de jogo precisar de uma tira de linha única final ou atlas misto, primeiro gere e faça o QC da ação como uma grade de várias linhas, depois monte a tira/atlas de entrega deterministicamente.
  • Em cada prompt de grade corporal animada, exija que o corpo do sujeito permaneça centralizado em cada célula, corpo inteiro dentro da área segura central de 60% a 70%, escala consistente entre as células, linha de ancoragem de pés/fundo estável quando aplicável, e sem membros, armas, cabelos, capas, poeira, flashes de boca ou FX destacados cruzando as bordas das células.
  • Para prompts de ataque corporal de herói, exija explicitamente que a altura do corpo e a escala do corpo correspondam às folhas de idle/run aceitas, pés/âncora inferior estáveis, arma mantida suficientemente próxima para não alargar a caixa delimitadora do corpo, e nenhum arco de corte destacado ou efeito de ataque em espaço de tela.
  • Para pacotes de props de mapa, classifique os props antes de escolher uma grade. Pacotes quadrados 2x2, 3x3 e 4x4 são apenas para props compactos. Não coloque plataformas, pisos, pontes, paredes, escadas, portões, portas, perigos longos, objetos largos/altos, objetos de colisão ou peças de tileset/tira em pacotes de props quadrados; use um por um, tiras 1x3/1x4, células largas personalizadas ou um atlas do tipo tileset.
  • Mantenha a regra de fundo sólido #FF00FF a menos que o usuário queira explicitamente um fluxo de trabalho de processamento diferente.

Fluxo de Trabalho

1. Inferir o plano do ativo

Escolha a menor saída útil.

Exemplos:

  • herói controlável com quatro direções -> player + player_sheet
  • herói controlável de visão lateral com idle/run/shoot/jump -> player + hero_action_bundle
    • folha de grade idle, geralmente 2x2 para 4 quadros
    • folha de grade run, geralmente 2x2 ou 2x3 dependendo da contagem de quadros necessária
    • folha de grade shoot apenas com corpo/arma, geralmente 2x2
    • folha de grade jump, geralmente 2x2
    • projétil/flash de boca como ativos separados quando necessário
    • atlas de motor opcional montado após QC por ação
  • herói controlável de visão lateral com ataque corpo a corpo -> player + hero_action_bundle
    • folha de grade de ataque corporal, geralmente 2x2 ou 2x3, apenas corpo
    • arco de corte/rastro de arma como uma folha fx separada quando o ataque precisar de um efeito visual amplo
    • faísca de impacto como uma folha impact separada quando os acertos precisarem de feedback
  • NPC curandeiro de mundo superior -> npc + single_asset ou unit_bundle
  • loop idle de chefe grande -> creature + idle + 3x3
  • mago lançando um orbe mágico -> spell_bundle
    • folha de lançamento do conjurador
    • loop de projétil
    • explosão de impacto
  • solicitação de linha de monstro -> line_bundle
    • planeje 1-3 formas
    • por forma, faça as folhas que a solicitação realmente precisa

2. Escrever o prompt manualmente

Use references/prompt-rules.md.

Escolha art_style antes de escrever o prompt:

  • Use pixel_art ou retro_pixel para sprites clássicos, personagens de RPG 16 bits e solicitações que pedem explicitamente pixel art.
  • Use clean_hd para props de mapa ou ativos destinados a combinar com mapas HD pintados à mão limpos.
  • Use pixel_inspired apenas quando o usuário quiser um visual adjacente a pixel sem a rigidez retrô.
  • Use map_style ou project-native quando um mapa, jogo ou referência existente deve definir o estilo.

Se uma referência estiver envolvida:

  • Conecte a referência na chamada: passe seu file_path do sandbox para imagine_image_to_image — ou a lista de caminhos para imagine_reference_to_image para 2+ referências (imagens geradas já têm um file_path; arquivos locais usam seu caminho do sandbox). Também read_file referências locais para que você possa vê-las.
  • Declare explicitamente o papel da referência: preservar identidade/estilo, criar uma folha de animação para o mesmo sujeito, criar uma evolução/variante ou derivar um prop/FX correspondente.
  • Preserve os marcadores de identidade estáveis da referência: silhueta, paleta, características faciais/de olhos, marcas de figurino, acessórios principais e linguagem material.
  • Deixe apenas a ação ou evolução solicitada mudar. Não redesenhe o sujeito a menos que o usuário peça.
  • Ainda exija forma exata da folha, fundo magenta sólido, contenção de quadros e mesma escala entre os quadros.

Mantém as partes estritas:

  • fundo #FF00FF sólido
  • forma exata da folha
  • mesma identidade de personagem ou ativo entre os quadros
  • mesma caixa delimitadora e escala de pixel entre os quadros
  • contenção explícita: nada pode cruzar as bordas das células

Barreira de segurança do atlas de ação mista:

  • Não peça ao imagine_text_to_image para gerar linhas de ação não relacionadas em uma folha bruta, como linha 1 idle, linha 2 run, linha 3 shoot, linha 4 jump, para um herói controlável ou personagem principal.
  • Não peça ao imagine_text_to_image para gerar tiras de ação brutas de linha única como 1x4 idle, 1x4 run, 1x4 shoot ou 1x4 jump para um herói controlável, personagem, criatura, NPC, inimigo, invocação ou prop animado.
  • Se um motor precisar de um 4x4, 5x5, atlas personalizado ou formato de entrega de tira de linha combinado, gere as grades de ação separadamente, processe e faça o QC delas separadamente, depois monte o atlas de entrega deterministicamente.
  • Exceções são folhas de locomoção direcional canônica, uma sequência de ação longa contínua, pacotes de props, atlas do tipo tileset e folhas compactas de combate inimigo de baixo risco. Estas ainda precisam de um prompt coerente e QC visual.
  • Mantenha projéteis, flashes de boca, impacto, rastros de poeira e FX destacados em folhas separadas, a menos que eles sejam intencionalmente parte da mesma silhueta de ação e permaneçam firmemente anexados.
  • Para heróis controláveis e personagens principais, "firmemente anexado" não é suficiente quando o efeito torna a caixa delimitadora da ação muito mais larga ou mais alta do que idle/run. Divida arcos de corte largos, flashes de boca, rastros de arma longos, nuvens de poeira e explosões de impacto em folhas FX separadas por padrão.

Barreira de segurança da grade corporal animada:

  • 1x4 e outras folhas brutas de linha única não são padrões válidos para corpos animados. Isso inclui jogadores, heróis controláveis, criaturas, NPCs, inimigos, invocações, props animados e ações de combate anexadas ao corpo.
  • Use 2x2 para ações corporais de 4 quadros. Este é o padrão para idle, ataque curto, corpo de tiro, pulo, ferido, pairar e ações compactas de andar/correr de visão lateral.
  • Use 2x3 para ações corporais de 6 quadros, como lançar feitiço, atacar, invocar, correr, carregar ou transformação.
  • Use 2x4, 3x3, 3x4 ou 4x4 para ações corporais mais longas. Prefira uma grade compacta a uma linha longa.
  • Para caminhada de cima para baixo de 4 direções, 4x4 pode permanecer uma forma de geração bruta porque é uma folha de locomoção direcional canônica, não quatro linhas de ação não relacionadas.
  • Se o runtime final precisar de uma tira de linha, monte-a após o QC a partir dos quadros da grade de várias linhas processados.
  • Mantenha o personagem centralizado em cada célula. A linha central do corpo deve permanecer perto do centro da célula, a âncora dos pés/fundo deve permanecer na mesma posição y quando visível, e o sujeito deve ocupar apenas a área segura central com preenchimento magenta generoso.
  • Para ataque, tiro, lançamento, carga e outras ações corporais, a altura do corpo deve permanecer próxima à altura do corpo idle/run aceita. Se um runtime de célula fixa estiver sendo usado, rejeite a saída da ação corporal quando o corpo aparecer mais de cerca de 10-15% menor do que idle/run, mesmo se edge_touch_frames estiver vazio.

Barreira de segurança do pacote de props de mapa:

  • Use pacotes de props brutos quadrados 2x2, 3x3 e 4x4 apenas para props compactos, como pedras, arbustos, barris, caixotes, luminárias, pequenas placas, vasos, detritos e pequenos ornamentos.
  • Não use pacotes de props quadrados para objetos de mapa largos ou críticos de colisão: pisos, plataformas, saliências, pedaços de terreno, pontes, trechos de parede, escadas, estradas, trilhos, canos, armadilhas de espinhos longas, portões, portas, edifícios, árvores grandes, pontos de verificação, saídas ou almofadas de construção.
  • Use geração um por um para props únicos, grandes, importantes, altos, irregulares ou alinhados por colisão.
  • Use tiras 1x3 ou 1x4 para ativos repetíveis de plataforma/piso, com tampa esquerda, repetição do meio, tampa direita e variante opcional de inclinação/canto/fim.
  • Use células largas personalizadas para múltiplos si

…

[truncado para tradução]

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

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

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).

Habilidades Relacionadas