elixir-performance-review — скилл для Claude Code: перформанс Elixir
Скилл elixir-performance-review для Claude Code проверяет код на Elixir и ищет узкие места в GenServer, памяти, конкурентности и базе данных. Находит причины просадки сервиса под нагрузкой.
Apache-2.0 107 установок ★ 89 обновлён 2026-09-15
npx skills add existential-birds/beagle --skill elixir-performance-review -a claude-codeЧто делает elixir-performance-review
Скилл проходит код на Elixir по чек-листу из четырёх блоков: GenServer, память, конкурентность, база данных. К каждому блоку приложен справочник — references/genserver-bottlenecks.md, references/ets-patterns.md, references/memory.md и references/concurrency.md. Агент открывает нужный файл вместо общих рассуждений.
Есть секция Valid Patterns: то, что помечать не надо. Один GenServer на низкой нагрузке, синхронные вызовы на критичном пути, Enum вместо Stream на маленьких коллекциях. Пороги заданы в Context-Sensitive Rules: про узкое место GenServer речь идёт при нагрузке выше 1000 запросов в секунду или блокирующем I/O в колбэках, про стримы свыше 10k элементов, про ETS при соотношении чтений к записям больше 10:1.
Перед отчётом агент проходит гейты. Каждое замечание привязано к path:line или к Module.function/arity с цитатой из файла, а слова про узкое место или N+1 подкреплены замером либо выгрузкой профайлера. Первый гейт требует прочитать review-verification-protocol из того же набора; без него проверка не проходит, поэтому ставьте оба скилла.
Какие задачи решает
- найти блокирующие вызовы в
handle_call - решить, когда состояние GenServer пора выносить в ETS
- поймать N+1 при прелоаде связей
- проверить, копируются ли большие бинари между процессами
- добавить backpressure производителю сообщений
Примеры запросов агенту
- Проверь
lib/orders/queue.exна перформанс: колбэки GenServer и работа с бинарями. - Сделай ревью воркера на конкурентность, особенно интересует неограниченный спавн процессов.
- Посмотри модуль
Stats.Cacheи скажи, не пора ли чтение перевести в ETS.
Как установить elixir-performance-review
1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill elixir-performance-review -a claude-code2Вручную: положить файлы
~/.claude/skills/elixir-performance-review/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/elixir-performance-review/
1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill elixir-performance-review -a codex2Вручную: положить файлы
.agents/skills/elixir-performance-review/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill elixir-performance-review -a cursor2Вручную: положить файлы
.cursor/skills/elixir-performance-review/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install existential-birds/beagle plugins/beagle-elixir/skills/elixir-performance-review2Вручную: положить файлы
.github/skills/elixir-performance-review/SKILL.md1Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill elixir-performance-review -a gemini-cli2Командой платформы
gemini skills install https://github.com/existential-birds/beagle --path plugins/beagle-elixir/skills/elixir-performance-reviewВручную: положить файлы
.devin/skills/elixir-performance-review/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add existential-birds/beagle --skill elixir-performance-review -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы об elixir-performance-review
Как установить elixir-performance-review в Claude Code?
Выполните npx skills add existential-birds/beagle --skill elixir-performance-review -a claude-code. Скилл появится по пути ~/.claude/skills/elixir-performance-review/SKILL.md.
Что делает elixir-performance-review?
Прогоняет Elixir-код по чек-листу производительности: GenServer, память, конкурентность, запросы к базе. Каждое замечание должно быть привязано к строке файла и подкреплено замером.
Что нужно, чтобы скилл работал?
Скилл review-verification-protocol из того же репозитория: его проверки входят в обязательные гейты перед отчётом. Для утверждений о нагрузке нужны замеры или выгрузки профайлера.
Исходный текст
SKILL.md · Apache-2.0
--- name: elixir-performance-review description: Reviews Elixir code for performance issues including GenServer bottlenecks, memory usage, and concurrency patterns. Use when reviewing high-throughput code or investigating performance issues. --- # Elixir Performance Review ## Quick Reference | Issue Type | Reference | |------------|-----------| | Mailbox overflow, blocking calls | [references/genserver-bottlenecks.md](references/genserver-bottlenecks.md) | | When to use ETS, read/write concurrency | [references/ets-patterns.md](references/ets-patterns.md) | | Binary handling, large messages | [references/memory.md](references/memory.md) | | Task patterns, flow control | [references/concurrency.md](references/concurrency.md) | ## Review Checklist ### GenServer - [ ] Not a single-process bottleneck for all requests - [ ] No blocking operations in handle_call/cast - [ ] Proper timeout configuration - [ ] Consider ETS for read-heavy state ### Memory - [ ] Large binaries not copied between processes - [ ] Streams used for large data transformations - [ ] No unbounded data accumulation ### Concurrency - [ ] Task.Supervisor for dynamic tasks (not raw Task.async) - [ ] No unbounded process spawning - [ ] Proper backpressure for message producers ### Database - [ ] Preloading to avoid N+1 queries - [ ] Pagination for large result sets - [ ] Indexes for frequent queries ## Valid Patterns (Do NOT Flag) - **Single GenServer for low-throughput** - Not all state needs horizontal scaling - **Synchronous calls for critical paths** - Consistency may require it - **In-memory state without ETS** - ETS has overhead for small state - **Enum over Stream for small collections** - Stream overhead not worth it ## Context-Sensitive Rules | Issue | Flag ONLY IF | |-------|--------------| | GenServer bottleneck | Handles > 1000 req/sec OR blocking I/O in callbacks | | Use streams | Processing > 10k items OR reading large files | | Use ETS | Read:write ratio > 10:1 AND concurrent access | ## Gates — before reporting Do these **in order** for the performance review. Do not publish findings until each step passes. 1. **Protocol loaded** — Read [review-verification-protocol](../review-verification-protocol/SKILL.md) and apply its checks for each finding (hot paths, concurrency, resource use). **Pass:** For every substantive finding, you can name which protocol subsection you satisfied or state **N/A** with reason (e.g. pure reference to this skill’s Valid Patterns). 2. **Anchored evidence** — **Pass:** Each finding includes a concrete locator: `path:line` (or line range), or `Module.function/arity` plus a short quoted snippet from the file. 3. **Performance claims** — For anything under [Context-Sensitive Rules](#context-sensitive-rules), or any claim of bottleneck, N+1, unbounded growth, or heavy memory/binary cost, **Pass:** You state the **observed or measured** fact that meets “Flag ONLY IF” (e.g. rate, item count, ratio), or attach an artifact (profiler output, SQL/log excerpt, `grep`/search scope)—otherwise downgrade to **question** / **suspected** with what was not verified. ## Before Submitting Findings Complete **Gates — before reporting** (section above) first; the verification protocol is mandatory input to those gates.
© existential-birds · Apache-2.0 · existential-birds/beagle