Grok Build Docstools · skills · окружение

Skills

Playbooks агента

Skills лежат в .grok/skills/ и подключаются до реализации. На карточке skill — краткое RU-описание; внутри — полный оригинальный SKILL.md на английском без перевода.

Общее описание skills

Skills — это playbooks (инструкции), которые агент читает перед реализацией. Они не добавляют кнопки в готовое приложение и не являются npm-пакетами: это знания о том, как правильно собрать UI, игру, ассеты, БД или auth в этом sandbox.

Что это

Markdown-playbooks в .grok/skills/<name>/SKILL.md (часто с references/ и scripts/). В frontmatter — name, description, short-description и триггеры. Агент открывает нужный skill до кода, а не «по памяти».

Чем отличаются от tools

Tools — действия (прочитать файл, сгенерировать картинку, запустить shell). Skills — как и когда эти действия применять: дизайн-токены, знаки WASD, пайплайн magenta-спрайтов, dual-mode Postgres. Tools без skills дают «технически работает, но криво».

Когда открывать

По типу задачи, не по настроению. Любой интерфейс → design-ui. Игра / canvas / 3D → building-games (+ controls при движении). 2D-арт персонажа → generate2dsprite; карта/уровень → generate2dmap. Persist/SQL → neon; логин → auth (opt-in). Не угадывать, если skill уже закрывает тему.

Область действия

Skill действует на дерево каталога, в котором лежит. Вложенные инструкции сильнее верхних при конфликте; прямые слова пользователя в чате сильнее любого skill.

Состав типичного skill

SKILL.md — правила и чеклисты; references/ — глубина (типографика, жанры, API); scripts/ — локальные постпроцессы (chroma key, compose map). Specialist-skills (анимация, тайлы, consistency) дополняют game-asset-core, а не заменяют его.

Как сочетать

Игра = building-games (canvas) + design-ui (HUD/меню) + controls (ввод) + generate2dsprite/map при нужде в артах. Auth и neon — только если нужны аккаунты или серверные данные. Multiplayer-p2p — для WebRTC mesh 2–8 игроков.

Базовые правила

  • Сначала triage запроса, потом skill, потом scaffold — не наоборот.
  • Для UI всегда design-ui (включая overlay игры).
  • Для движения/WASD — controls до кода; инвертированный A/D — ship-blocker.
  • Реальные 2D-ассеты через generate2dsprite / generate2dmap, не stick-figure placeholders (если пользователь не просил иначе).
  • Auth opt-in: лендинги, калькуляторы, одиночные игры без сохранений — без login.
  • Не игнорировать skill, если триггер явно совпал с задачей.

Быстрая карта: задача → skill

НужноSkill
Красивый сайт, дашборд, формы, HUDdesign-ui
Игра, симуляция, canvas, 3Dbuilding-games
WASD, руль, полёт, mouse-lookcontrols
Three.js API / шейдеры / GLTFthreejs
Спрайт-шиты, walk/attack cyclesgenerate2dsprite
Карты, уровни, prop packsgenerate2dmap
Плотная анимация из videovideo2dsprite
База данных, persistneon
Логин, аккаунты, per-user dataauth
Realtime P2P между игрокамиmultiplayer-p2p

16 / 16

Группы

Интерфейс

1

Дизайн-система, polish, anti-slop для DOM/overlay UI.

Игры и 3D

3

Игровой цикл, управление, Three.js, жанры.

Игровые ассеты

8

Спрайты, карты, тайлы, анимация, иконки UI.

Данные и auth

2

Postgres/Neon, аутентификация.

Мультиплеер

1

P2P WebRTC mesh.

Imagine / медиа

1

Промптинг image_gen / image_edit.

Все skills — полный оригинал внутри

design-uiИнтерфейс

Полированный UI: токены, типографика, anti-slop

Единый skill для любого интерфейса: страницы, лендинги, дашборды, формы, HUD и меню поверх игры. Дизайн-токены в CSS (@theme), shadcn/Radix, шкала spacing, motion, запрет «AI-slop» (фиолетовые градиенты, emoji-иконки, generic Inter-only). Обязателен перед стилизацией любого DOM-UI.

Full SKILL.md (EN, no translation) →
building-gamesИгры и 3D

Браузерные игры: loop, камера, perf, жанры

Главный skill для игр и interactive/canvas/3D. Игровой цикл и тайминг, ориентация 3D/камера, коллизии, производительность, audio, save, game feel. Есть references по жанрам (platformer, FPS, racing, voxel, tower defense…). Single-player. Overlay UI — через design-ui; знаки WASD — через controls.

Full SKILL.md (EN, no translation) →
controlsИгры и 3D

Знаки управления: WASD, техника, self-test A=влево

Критичный skill: правильные знаки ввода (A = влево), vehicle/flight maps, mouse-look, обязательные self-tests. Инвертированный A/D — частый ship-blocker. Читать до кода движения.

Full SKILL.md (EN, no translation) →
threejsИгры и 3D

Three.js + TSL: полный API-справочник

Официальный LLM-пакет документации Three.js/TSL. Для WebGL/WebGPU, шейдеров, GLTF, материалов. Корректность игры (loop, WASD, камера) — building-games; глубина API — этот skill.

Full SKILL.md (EN, no translation) →
generate2dspriteИгровые ассеты

2D спрайт-шиты: image_gen + magenta chroma

Production 2D-спрайты и animation sheets: персонажи, projectiles, FX, props. Пайплайн: генерация на solid magenta (#FF00FF) + локальные chroma-скрипты. Предпочтительнее code-drawn placeholders.

Full SKILL.md (EN, no translation) →
generate2dmapИгровые ассеты

2D карты: layered art, props, collision metadata

Карты и уровни: top-down RPG, side-scroller stages, tilemaps, prop packs, зоны коллизий. Foundation + отдельные props. Целевые стеки: raw canvas / Phaser.

Full SKILL.md (EN, no translation) →
video2dspriteИгровые ассеты

Video→плотные спрайты (image_to_video + chroma)

Плотнее motion: base image → image_to_video → ffmpeg frames → magenta chroma. Для гладких walk/run. Для crisp pixel production sheets предпочтительнее generate2dsprite.

Full SKILL.md (EN, no translation) →
game-asset-coreИгровые ассеты

Базовые правила engine-ready игровых ассетов

Дисциплина для любой генерации game art: дефолты, чеклисты, style anchoring, read-back verification. Затем подключать specialist skill (animation / tiles / character / ui-icons).

Full SKILL.md (EN, no translation) →
game-animation-framesИгровые ассеты

Анимационные кадры: video-first подход

Motion cycles, action keyframes, FX sequences. Видео-генератор лучше понимает движение — не просить mid-motion poses у image model вслепую.

Full SKILL.md (EN, no translation) →
game-character-consistencyИгровые ассеты

Один персонаж на всех кадрах

Turnarounds, damage variants, palette swaps, equipment — identity, не одиночная картинка. Asymmetry bookkeeping для front/side/back.

Full SKILL.md (EN, no translation) →
game-tilesetsИгровые ассеты

Бесшовные тайлы и transition sets

Seamless textures, terrain transitions, autotiles. Критерий: игрок не должен видеть сетку.

Full SKILL.md (EN, no translation) →
game-ui-iconsИгровые ассеты

Game UI kits и иконки

Кнопки со states, панели, bars, wordmark, icon sets. UI как система: согласованный набор важнее одиночного ассета.

Full SKILL.md (EN, no translation) →
imagineImagine / медиа

Промптинг image_gen / image_edit

Когда генерировать vs рисовать кодом, craft промптов, reference-first для людей, factual grounding, consistency. Не замена generate2dsprite/map для sheeted game assets.

Full SKILL.md (EN, no translation) →
neonДанные и auth

Neon Postgres + PGLite fallback

Dual-mode БД: Neon при DATABASE_URL, иначе PGLite в preview. Единый API через @/lib/db. Миграции в migrations/*.sql. Для persist / per-user data.

Full SKILL.md (EN, no translation) →
authДанные и auth

Auth: Google, X (broker) или email/password

Better Auth на /api/auth/* + Grok auth broker. Провайдеры: Google, X; опционально local email/password. Opt-in: не ставить login на landing/games без нужды. Real sign-in в preview.

Full SKILL.md (EN, no translation) →
multiplayer-p2pМультиплеер

WebRTC P2P mesh, сигнал /api/rtc

Полный mesh: data channels peer-to-peer, сервер только handshake. 2–8 игроков, low latency, shared cursors, party games. Игровой трафик не через сервер.

Full SKILL.md (EN, no translation) →