Communitygithub.com

evalix098/tiktoklive

TanStack Start + React + Tailwind v4 + shadcn/Radix 앱을 위한 정제되고 비범한 UI를 설계하고 구축합니다. 페이지, 랜딩 페이지, 대시보드, 폼, 모달, 내비게이션 및 게임 오버레이(시작 화면, HUD, 메뉴) 등 모든 인터페이스 표면을 생성하거나 스타일을 변경할 때 사용하세요. 디자인 토큰, 레이아웃, 타이포그래피, 색상, 간격, 모션, 그리고 출력물이 평범해 보이지 않게 방지하는 'AI-슬롭' 방지 규칙을 다룹니다.

tiktoklive란 무엇인가요?

이 스킬은 고품질의 의도적인 UI를 제작하기 위한 포괄적인 디자인 시스템으로, 'AI-슬롭'이라 불리는 템플릿처럼 보이는 평범한 출력을 방지하는 데 중점을 둡니다. TanStack Start, React, Tailwind v4, shadcn/ui, Radix 프리미티브로 구축된 앱을 대상으로 하며, 페이지, 대시보드, 모달, 게임 HUD와 같은 모든 DOM/오버레이 UI 표면에 적용됩니다. 주요 기능으로는 `@theme`에서 CSS 변수로 정의된 디자인 토큰을 통한 일관된 디자인 시스템 우선 접근법, 색상 및 폰트 제한, 일관된 간격 척도, 모바일 우선 반응형 등 정량화된 평가 기준을 제공합니다. 또한 그라디언트 블롭, 이모지 아이콘, 손으로 그린 SVG, 플레이스홀더 이미지 등 흔히 볼 수 있는 안티 패턴을 금지합니다. 세부 규칙과 예시는 `references/` 디렉토리의 참조 문서에 저장되어 있으며, 필요 시 불러와 사용합니다. 최종 체크리스트를 통해 렌더링 및 브라우저에서 시각적 검증까지 완료해야 UI 작업이 완료됩니다.

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

즐겨 사용하는 AI에게 물어보기

이 에이전트 스킬이 미리 로드된 새 채팅을 엽니다.

문서

디자인 & UI

의도적이고 프리미엄처럼 보이는 인터페이스를 만드세요. 템플릿처럼 평범하지 않게요. 이것이 앱 빌더에서 가장 중요한 품질 향상 요소입니다. DOM / 오버레이 UI — 페이지, 크롬, HUD, 메뉴, 폼에 적용하세요. (3D 게임의 게임플레이 캔버스는 building-games 스킬을 참조하세요. 이 스킬은 그 위에 계층화된 DOM UI를 관리합니다.)

상세 내용은 references/를 읽으세요 (필요 시 불러오며, 전부 인라인으로 넣지 마세요):

  • references/refined-ui.md — 전체 제품-크롬/오버레이 디자인 시스템.
  • references/typography.md — 서체 스케일, 페어링, 리듬.
  • references/surfaces.md — 입면, 테두리, 그림자, 계층.
  • references/animations.md — 모션, 이징, 전환.
  • references/performance.md — UI를 부드럽게 유지 (60fps, 끊김 없음).

1. 디자인 시스템 우선 (스타일링 전에 먼저 하세요)

시스템을 한 번 정의하고, 그로부터 조합하세요. 임의의 값을 여기저기 흩뿌리지 마세요.

  • CSS의 토큰 (Tailwind v4는 CSS 우선). 팔레트, 반경, 폰트를 src/styles.css의 @theme 아래에 CSS 변수로 넣고, Tailwind 유틸리티로 사용하세요. 단일 진실 공급원입니다.
    @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;
    }
    
  • shadcn/ui 컴포넌트 사용 (Radix 프리미티브 + cva 변형 + tailwind-merge) — 버튼, 대화상자, 드롭다운, 입력 등에 사용하세요. 접근 가능하고 일관적입니다. src/components/ui에 생성하고 토큰으로 스타일링하세요. 인라인 hex는 사용하지 마세요.
  • Tailwind v4 기본 수정 — 버튼에 포인터 커서 필요. v4의 Preflight는 <button>에 cursor: default를 설정하여 어색하게 만듭니다. src/styles.css에 한 번 추가하여 버튼/클릭 가능한 역할이 포인터를 표시하도록 하세요:
    @layer base {
      button:not(:disabled),
      [role="button"]:not(:disabled) { cursor: pointer; }
    }
    
  • 임의 스타일링 금지: JSX에 원시 hex 사용 금지, text-white/bg-black 리터럴 금지, p-[16px] 또는 text-[13px] 같은 임의 값 금지. 값이 필요하면 토큰이나 스케일 단계로 만드세요.

2. 정량화된 평가 기준 ("못생김"을 방지하는 간단한 규칙)

  • 총 3~5색 이하 (기본 색상 1개 + 중성색 + 최대 강조색 1개). 임의의 추가 색조 없음. 요청하지 않으면 기본으로 보라색을 사용하지 마세요.
  • 최대 2개 폰트 패밀리 (보통 1개). 제목/표시용과 본문용을 짝짓거나 하나만 사용하세요.
  • 줄 높이 1.4~1.6 (본문); 큰 제목은 더 좁게.
  • 배경색을 재정의할 때는 전경/텍스트 색상도 함께 재정의하세요 (대비가 유지되어야 함 — 밝은 테마와 어두운 테마 모두 확인).
  • 모바일 우선: ~390px 레이아웃을 먼저 디자인하고, 그 다음 확장하세요. 수평 오버플로우 없음; 탭 대상 ≥ 44px.
  • 일관된 간격 스케일 (4/8 기준). 넉넉한 여백이 빽빽한 것보다 낫습니다.
  • 강조색 하나, 아껴서 사용 — 기본 액션에만, 모든 곳에 사용하지 마세요.

3. AI-슬롭 방지 (출력물이 평범해 보이게 하는 특징 — 피하세요)

  • 그라디언트 블롭 채우기 금지, 콘텐츠 대용으로 거대한 히어로 그라디언트 사용 금지.
  • 아이콘으로 이모지 사용 금지 — 실제 아이콘 세트(lucide-react)를 사용하세요.
  • 손으로 그린 SVG 일러스트레이션/지도/차트 금지 — 실제 라이브러리(recharts 차트) 또는 실제 생성된 이미지를 사용하세요.
  • 최종 제품에 플레이스홀더 이미지 / 회색 상자 금지 — 실제 이미지를 생성하거나 실제 콘텐츠를 사용하세요; 캔버스 이미지에 crossOrigin="anonymous"를 설정하세요.
  • 과도하게 사용된 폰트 모양 피하기 (기본 시스템 전용 또는 코믹산스 급 선택).
  • 모든 요소는 그 자리를 정당화해야 합니다. 장식적 잡음을 줄이세요. 시스템을 확립하고 의도에 따라 다양화하세요 — 무작위성은 피하세요.
  • 앱을 제자리에서 편집할 때 기존 UI와 일치시키세요; 두 번째 시각적 언어를 도입하지 마세요.

4. 레이아웃 & 계층 구조

  • 명확한 시각적 계층: 뷰당 하나의 기본 액션; 크기/굵기/색상으로 중요도를 표현하세요. references/typography.md 및 references/surfaces.md 참조.
  • 실제 레이아웃 구조 사용 (grid/flex, 컨테이너 최대 너비) — 절대 위치 해킹 사용 금지. 일관된 그리드에 정렬하세요.
  • 빈 상태, 로딩 상태, 오류 상태는 디자인의 일부입니다 — 빈/어색한 중간 상태를 제공하지 마세요.

5. 모션 (미묘하고, 목적적)

  • 짧고 부드러운 전환 (150~250ms) 호버/누름/진입 시; prefers-reduced-motion을 존중하세요. 자세한 내용은 references/animations.md 참조.
  • 레이아웃을 끊김 현상이 발생하는 방식으로 애니메이션하지 마세요; transform/opacity를 선호하세요.

6. 게임 오버레이 (building-games와 함께 사용 시)

게임플레이 캔버스는 building-games가 소유합니다. 이 스킬은 DOM 오버레이 스타일을 지정합니다: 시작/"클릭하여 플레이" 화면, HUD, 점수, 메뉴, 일시 중지, 모바일 컨트롤. 오버레이를 캔버스 위에서 읽기 쉽게 유지하고 (배경, 대비) 포인터 잠금/게임플레이 입력 경로에서 벗어나게 유지하세요.


완료 체크리스트 (UI 완료 전에 확인하세요)

  • @theme에 토큰 정의됨; JSX에 임의 hex / 임의 값 없음.
  • 5색 이하, 2개 폰트 이하, 일관된 간격 스케일.
  • 대비 유지됨; 배경이 재정의된 곳마다 전경도 재정의됨.
  • 모바일 (~390px)에 오버플로우 없음; 대상 ≥ 44px.
  • 실제 아이콘/이미지/차트 — 안티-슬롭 특징 없음.
  • 로딩/빈/오류 상태 처리됨; 모션은 미묘하고 축소-모션 안전.
  • 브라우저에서 렌더링 및 육안 확인됨 (AGENTS.md 검증 참조), 단순 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).

관련 스킬