К основному содержанию
скилл CX Codex

elixir-performance-review — скилл для Claude Code: перформанс Elixir

Скилл elixir-performance-review для Claude Code проверяет код на Elixir и ищет узкие места в GenServer, памяти, конкурентности и базе данных. Находит причины просадки сервиса под нагрузкой.

Apache-2.0 107 установок ★ 89 обновлён 2026-09-15

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add existential-birds/beagle --skill elixir-performance-review -a claude-code
Открыть на GitHub

Что делает 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-code

2Вручную: положить файлы

~/.claude/skills/elixir-performance-review/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/elixir-performance-review/

По шагам, с командами для каждой платформы: Как установить скилл в 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

Похожие скиллы

Все скиллы по теме «Код-ревью и рефакторинг» →
elixir-otp-patterns TheBushidoCollective Скилл elixir-otp-patterns помогает проектировать конкурентные отказоустойчивые сервисы на Elixir с опорой на проверенные архитектурные паттерны OTP. CX Codex +1 106установок review-hog-perspective-performance-reliability PostHog Скилл review-hog-perspective-performance-reliability проверяет код на проблемы с производительностью и надёжностью: от запросов к базе до обработки ошибок. Запускайте его при ревью изменений. CX Codex +1 187установок elixir-expert VoltAgent Субагент elixir-expert для задач с Elixir и OTP: процессы, супервизия, отказоустойчивость, Phoenix. Анализирует границы выполнения, находит корни проблем и предлагает минимальные безопасные изменения. CX Codex ★ 6 505звёзд репо performance-testing-review Seth Hobson Плагин performance-testing-review для Claude, Codex и Cursor: смотрит производительность кода, покрытие тестами и качество по оценке ИИ. CX Codex ★ 42 780звёзд репо java-code-review decebals Скилл java-code-review прогоняет Java-код по чек-листу: null safety, исключения, конкурентность, утечки ресурсов. Пригодится перед мержем PR. CX Codex +1 1 200установок elixir Mindrally Задаёт агенту стиль работы с Elixir и Phoenix: функциональные паттерны, Ecto, LiveView, OTP. Используется в проектах на BEAM. CX Codex +1 881установок

Из того же набора68

Весь набор →
pydantic-ai-model-integration Скилл pydantic-ai-model-integration помогает настроить провайдеров LLM, цепочки fallback, стриминг и лимиты токенов в библиотеке PydanticAI. CX Codex +1 120установок review-ai-writing Скилл review-ai-writing находит следы текстов нейросетей в документации, комментариях к коду, текстах коммитов и описаниях пулреквестов. Пригодится при проверке репозитория на канцелярский слог и роботизированные фразы. CX Codex +1 119установок wish-ssh-code-review Скилл wish-ssh-code-review проверяет код SSH-серверов на базе Go-библиотеки Charmbracelet Wish: порядок middleware, работу с PTY, ключи хоста и корректное завершение работы. CX Codex +1 119установок urlsession-code-review Скилл urlsession-code-review разбирает сетевой код на URLSession в iOS и macOS: статус-коды, кэш, таймауты и фоновые сессии. Находки идут с привязкой file:line. CX Codex +1 116установок elixir-security-review Скилл elixir-security-review проверяет код на Elixir на уязвимости: инъекции кода, переполнение таблицы атомов и утечки секретов. CX Codex +1 110установок elixir-writing-docs Скилл elixir-writing-docs для Claude Code оформляет документацию Elixir в файлах .ex: аннотации ExDoc, doctests и метаданные. CX Codex +1 106установок rust-code-review Скилл rust-code-review для Claude Code проверяет Rust-код при ревью файлов .rs. Разбирает владение, заимствования, обработку ошибок, трейты и небезопасный код. CX Codex +1 104установок vercel-ai-sdk Справочник по Vercel AI SDK для сборки стриминговых чатов, вызова инструментов и обработки вложений. CX Codex +1 101установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой