Communitygithub.com

Conception UI & Design

Concevez et construisez des interfaces polies et non génériques pour cette application TanStack Start + React + Tailwind v4 + shadcn/Radix. Utilisez-le chaque fois que vous créez ou restylisez une surface d'interface — pages, pages d'accueil, tableaux de bord, formulaires, modales, navigation et superpositions de jeu (écrans de démarrage, HUD, menus). Couvre les tokens de design, la mise en page, la typographie, la couleur, l'espacement, le mouvement et les règles anti-« slop IA » qui empêchent le rendu générique.

Qu'est-ce que Conception UI & Design ?

Cette compétence (skill) définit un système de conception UI complet pour une application TanStack Start + React + Tailwind v4 + shadcn/Radix. Elle vise à éliminer le rendu générique souvent produit par les IA en imposant des règles strictes : utilisation de tokens CSS via `@theme`, palette limitée à 3–5 couleurs, maximum 2 familles de polices, espacement cohérent (base 4/8), et une grille de mise en page mobile-first. Elle s'applique à toutes les surfaces d'interface DOM (pages, tableaux de bord, formulaires, modales, navigation) ainsi qu'aux superpositions de jeu (écran de démarrage, HUD, menus) en complément d'une compétence dédiée au gameplay 3D. La compétence fournit une rubrique quantifiée (ligne de hauteur, taille des cibles tactiles, contrastes) et des règles anti-« slop IA » (pas d'emoji comme icônes, pas de dégradés vides, pas d'images placeholder). Les développeurs sont invités à lire les fichiers de référence dans `references/` pour approfondir la conception des surfaces, la typographie, les animations et la performance. Chaque modification UI doit respecter une checklist finale incluant la vérification des tokens, des contrastes, de l'absence de débordement mobile et de l'utilisation d'icônes/images réelles.

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

Demander à votre IA préférée

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

Documentation

Conception & UI

Créez des interfaces qui semblent intentionnelles et premium, pas génériques comme des templates. C'est le levier de qualité le plus important dans le constructeur d'applications. Appliquez-le à l'interface DOM / superposition — pages, chrome, HUD, menus, formulaires. (Pour le canevas de jeu d'un jeu 3D, voir la compétence building-games ; cette compétence régit l'interface DOM superposée dessus.)

Lisez references/ pour approfondir (chargé à la demande — ne l'intégrez pas en entier) :

  • references/refined-ui.md — le système de design complet pour le chrome produit/superposition.
  • references/typography.md — échelle typographique, association, rythme.
  • references/surfaces.md — élévation, bordures, ombres, superposition.
  • references/animations.md — mouvement, easing, transitions.
  • references/performance.md — gardez l'interface fluide (60 ips, pas de saccades).

1. Design-system-first (faites cela avant de styliser quoi que ce soit)

Définissez le système une fois, puis composez à partir de lui. Ne dispersez jamais des valeurs ad-hoc.

  • Tokens en CSS (Tailwind v4 est CSS-first). Mettez la palette, les rayons et les polices dans src/styles.css sous @theme en tant que variables CSS ; consommez-les comme des utilitaires Tailwind. Une seule source de vérité.
    @import "tailwindcss";
    @theme {
      --color-bg: #0b0b0f;      --color-surface: #16161d;
      --color-fg: #e7e7ea;      --color-muted: #a0a0ab;
      --color-primary: #14b8a6; --color-border: #26262f;
      --radius: 0.75rem;        --font-sans: "Inter", system-ui, sans-serif;
    }
    
  • Utilisez les composants shadcn/ui (primitives Radix + variantes cva + tailwind-merge) pour les boutons, dialogues, menus déroulants, champs de saisie, etc. Ils sont accessibles et cohérents. Générez-les dans src/components/ui ; stylisez via les tokens, pas via des hexadécimaux en ligne.
  • Correctif de base Tailwind v4 — les boutons ont besoin d'un curseur en forme de pointeur. La pré-vérification de la v4 donne au <button> un cursor: default, ce qui semble cassé. Ajoutez ceci une fois dans src/styles.css pour que les boutons/rôles cliquables affichent un pointeur :
    @layer base {
      button:not(:disabled),
      [role="button"]:not(:disabled) { cursor: pointer; }
    }
    
  • Interdiction du style ad-hoc : pas d'hexadécimal brut dans le JSX, pas de littéraux text-white/bg-black, pas de valeurs arbitraires comme p-[16px] ou text-[13px]. Si vous avez besoin d'une valeur, elle devient un token ou un échelon d'échelle.

2. La grille d'évaluation quantifiée (règles bon marché qui empêchent le « moche »)

  • ≤ 3–5 couleurs au total (une primaire + neutres + au plus une d'accent). Pas de teintes supplémentaires aléatoires. Ne choisissez pas par défaut le violet sauf si demandé.
  • ≤ 2 familles de polices (souvent une). Associez une police d'affichage/titre avec une police de corps, ou utilisez-en une seule.
  • Hauteur de ligne 1,4–1,6 pour le corps ; plus serrée pour les grands titres.
  • Lorsque vous écrasez une couleur de fond, écrasez aussi la couleur du texte/avant-plan (le contraste doit tenir — vérifiez à la fois en mode clair et sombre).
  • Mobile-first : concevez d'abord la mise en page ~390 px, puis montez en échelle. Pas de débordement horizontal ; les cibles tactiles ≥ 44 px.
  • Échelle d'espacement cohérente (basée sur 4/8). L'espace blanc généreux bat le tassement.
  • Un accent, utilisé avec parcimonie pour les actions principales — pas partout.

3. Anti-« slop IA » (les signes qui rendent le rendu générique — à éviter)

  • Pas de remplissage par dégradé blob, pas de grands dégradés héros comme substitut au contenu.
  • Pas d'emoji comme icônes — utilisez un vrai jeu d'icônes (lucide-react).
  • Pas d'illustrations SVG dessinées à la main / de cartes / de graphiques — utilisez de vraies bibliothèques (recharts pour les graphiques) ou de vraies images générées.
  • Pas d'images placeholder / de boîtes grises lorem dans le produit final — générez de vraies images ou utilisez du vrai contenu ; définissez crossOrigin="anonymous" sur les images du canevas.
  • Évitez le look des polices trop utilisées (système par défaut uniquement, ou des choix de type Comic Sans).
  • Chaque élément mérite sa place. Réduisez le bruit décoratif. Établissez un système, puis variez avec intention — pas au hasard.
  • Correspondre à l'interface existante lorsque vous éditez une application en place ; n'introduisez pas un second langage visuel.

4. Mise en page & hiérarchie

  • Hiérarchie visuelle claire : une action principale par vue ; la taille/le poids/la couleur expriment l'importance. Voir references/typography.md et references/surfaces.md.
  • Utilisez une vraie structure de mise en page (grid/flex, largeurs maximales de conteneur), pas des astuces de positionnement absolu. Alignez-vous sur une grille cohérente.
  • Les états vides, les états de chargement et les états d'erreur font partie du design — ne livrez pas d'états intermédiaires vides/saccadés.

5. Mouvement (subtil, intentionnel)

  • Transitions courtes et avec easing (150–250 ms) au survol/au clic/à l'entrée ; respectez prefers-reduced-motion. Détails dans references/animations.md.
  • Ne jamais animer la mise en page d'une manière qui cause des saccades ; privilégiez transform/opacity.

6. Superpositions de jeu (lorsque cela s'associe à building-games)

Le canevas de jeu est géré par building-games. Cette compétence style la superposition DOM : écran de démarrage/« cliquer pour jouer », HUD, score, menus, pause, contrôles mobiles. Gardez la superposition lisible sur le canevas (fond, contraste) et maintenez-la en dehors du chemin de saisie du verrouillage de pointeur/du jeu.


Checklist de finition (avant de déclarer l'interface terminée)

  • Tokens définis dans @theme ; pas d'hexadécimal ad-hoc / de valeurs arbitraires dans le JSX.
  • ≤ 5 couleurs, ≤ 2 polices, échelle d'espacement cohérente.
  • Le contraste tient ; l'avant-plan est écrasé partout où le fond l'est.
  • Mobile (~390 px) sans débordement ; cibles ≥ 44 px.
  • Icônes/images/graphiques réels — aucun des signes de slop.
  • États de chargement/vide/erreur gérés ; mouvement subtil et sûr pour prefers-reduced-motion.
  • Rendu et inspecté visuellement dans un navigateur (voir vérification dans AGENTS.md), pas seulement via curl.

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

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

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