# game-performance-profiler

Разбирает жалобы на время кадра в Unity и Unreal: какой пакет данных доверять, где узкое место и какой замер сделать следующим.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 345 установок · ★ 51
- Автор: akillness
- Лицензия: не указана · policy=link-only · показываем только описание, файл — у автора
- Исходник: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/game-performance-profiler/SKILL.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/skills/game-performance-profiler

## Что делает

Скилл включается, когда есть скриншот профайлера, вывод `stat unit` или `stat gpu`, заметки по бенчмарк-маршруту либо пакет отзыва с целевого устройства. Сначала он собирает минимальный контекст: движок, целевая платформа, сборка (редактор или упакованная), симптом, доступные доказательства, сценарий воспроизведения и переменные качества вроде разрешения и пресета. Потом выбирает один основной режим работы: быстрый разбор, классификация узкого места, план бенчмарк-маршрута, обзор на устройстве или переход к более глубоким инструментам.

Дальше называется одна основная семья узких мест — скриптинг геймплея на CPU, давление draw call в потоке рендера, GPU-шейдеры и постобработка, сборка мусора и аллокации, загрузка и стриминг, физика с анимацией, платформенные и тепловые ограничения. Если доказательств мало, ставится `unknown-needs-better-capture`. После этого скилл советует самый дешёвый следующий замер, который реально разделит версии: один нормальный пакет из Unity Profiler на игровой сборке, пара `stat unit` и `stat gpu` на точном маршруте воспроизведения или захват на упакованном устройстве вместо новых скриншотов из редактора. К глубоким трейсам вроде Unreal Insights или GPU Visualizer он переходит только тогда, когда первый пакет это оправдывает.

Это рабочий процесс для триажа и планирования, а не автоматический оптимизатор. Скилл не правит код и не настраивает сборку сам: он выдаёт один артефакт, с которым команда может работать.

## Требования
- Работает с: Unity, Unreal Engine

## Установка

### Claude Code (родная платформа)

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill game-performance-profiler -a claude-code
```

2. **Вручную: положить файлы**
- Файл: `~/.claude/skills/game-performance-profiler/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/game-performance-profiler/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill game-performance-profiler -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/game-performance-profiler/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill game-performance-profiler -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/game-performance-profiler/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install akillness/jeo-skills game-performance-profiler
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/game-performance-profiler/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill game-performance-profiler -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/akillness/jeo-skills --path .agent-skills/game-performance-profiler
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/game-performance-profiler/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add akillness/jeo-skills --skill game-performance-profiler -a opencode
```

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/akillness/jeo-skills/tree/HEAD/.agent-skills/game-performance-profiler/SKILL.md

## Когда брать
- понять, какой из скриншотов профайлера вообще заслуживает доверия
- назвать одну основную семью узких мест вместо списка догадок
- выбрать следующий замер, который уточнит картину, а не раздует её
- отличить просадки на GPU от всплесков сборки мусора в бою
- решить, пора ли уходить с быстрых пакетов на Unreal Insights

## Примеры запросов агенту
- Вот скриншот `stat unit` с упакованной сборки на Steam Deck, просадка при переходе через рынок. Что это за узкое место и какой замер сделать следующим?
- Собери план бенчмарк-маршрута для сцены боя: прогрев, число повторов, что фиксировать.
- У меня есть трейс Unreal Insights и скриншот оверлея, но версии расходятся. Помоги выбрать одну основную семью узких мест.

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md