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

elixir-code-review — скилл для Claude Code

Скилл elixir-code-review проверяет код на Elixir по правилам OTP, безопасности и стиля. Помогает при разборе файлов .ex и .exs.

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

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

Что делает elixir-code-review

Скилл задаёт строгий чеклист для инспекции кода на Elixir. Он оценивает оформление пайплайнов, сопоставление с образцом во фрагментах with и заголовках функций, а также структуру процессов OTP. Например, агент проверяет перенос тяжелой инициализации в handle_continue и следит, чтобы в коллбэках GenServer не оставалось блокирующих вызовов.

В правилах прописан фильтр ложных срабатываний: пустые функции-гарды, единичные |> или отсутствие @spec у приватных функций ошибками не считаются. Для уязвимостей настроен запрет на вызовы String.to_atom/1 и Code.eval_string/1 поверх внешних данных.

Каждое замечание требует точной привязки к path:line и подтверждения найденными артефактами. Без протокола проверки замечания публиковать запрещено.

Какие задачи решает

  • найти уязвимости с атомами и небезопасной десериализацией в Elixir
  • проверить реализацию GenServer и Supervisor на блокирующие вызовы
  • выявить отсутствие спецификаций @spec и документации @doc у публичных функций
  • убрать лишние условия в пользу сопоставления с образцом и гардов

Примеры запросов агенту

  • Проверь модуль lib/app/worker.ex с помощью скилла elixir-code-review
  • Сделай ревью изменений в lib/auth.ex, проверь безопасность сопоставления с образцом
  • Оцени код lib/cache/server.ex по чек-листу OTP и GenServer

Как установить elixir-code-review

1Через Skills CLI (Vercel)

npx skills add existential-birds/beagle --skill elixir-code-review -a claude-code

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

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

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

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы об elixir-code-review

Как установить elixir-code-review в Claude Code?

Выполните команду npx skills add existential-birds/beagle --skill elixir-code-review -a claude-code. Файл настроек сохранится по пути ~/.claude/skills/elixir-code-review/SKILL.md.

Что делает скилл elixir-code-review?

Он предоставляет агенту чеклист для проверки Elixir-кода, охватывающий стиль, сопоставление с образцом, базовые принципы OTP, наличие документации и безопасность.

Какие шаблоны кода скилл считает допустимыми?

Он запрещает ругать пустые клозы функций для паттерн-матчинга, одиночные пайплайны |>, @doc false для реализаций коллбэков и отсутствие @spec у приватных функций.

Исходный текст

SKILL.md · Apache-2.0
---
name: elixir-code-review
description: Reviews Elixir code for idiomatic patterns, OTP basics, and documentation. Use when reviewing .ex/.exs files, checking pattern matching, GenServer usage, or module documentation.
---

# Elixir Code Review

## Quick Reference

| Issue Type | Reference |
|------------|-----------|
| Naming, formatting, module structure | [references/code-style.md](references/code-style.md) |
| With clauses, guards, destructuring | [references/pattern-matching.md](references/pattern-matching.md) |
| GenServer, Supervisor, Application | [references/otp-basics.md](references/otp-basics.md) |
| @moduledoc, @doc, @spec, doctests | [references/documentation.md](references/documentation.md) |

## Review Checklist

### Code Style
- [ ] Module names are CamelCase, function names are snake_case
- [ ] Pipe chains start with raw data, not function calls
- [ ] Private functions grouped after public functions
- [ ] No unnecessary parentheses in function calls without arguments

### Pattern Matching
- [ ] Functions use pattern matching over conditionals where appropriate
- [ ] With clauses have else handling for error cases
- [ ] Guards used instead of runtime checks where possible
- [ ] Destructuring used in function heads, not body

### OTP Basics
- [ ] GenServers use handle_continue for expensive init work
- [ ] Supervisors use appropriate restart strategies
- [ ] No blocking calls in GenServer callbacks
- [ ] Proper use of call vs cast (sync vs async)

### Documentation
- [ ] All public functions have @doc and @spec
- [ ] Modules have @moduledoc describing purpose
- [ ] Doctests for pure functions where appropriate
- [ ] No @doc false on genuinely public functions

### Security
- [ ] No `String.to_atom/1` on user input (use `to_existing_atom/1`)
- [ ] No `Code.eval_string/1` on untrusted input
- [ ] No `:erlang.binary_to_term/1` without `:safe` option

## Valid Patterns (Do NOT Flag)

- **Empty function clause for pattern match** - `def foo(nil), do: nil` is valid guard
- **Using `|>` with single transformation** - Readability choice, not wrong
- **`@doc false` on callback implementations** - Callbacks documented at behaviour level
- **Private functions without @spec** - @spec optional for internals
- **Using `Kernel.apply/3`** - Valid for dynamic dispatch with known module/function

## Context-Sensitive Rules

| Issue | Flag ONLY IF |
|-------|--------------|
| Missing @spec | Function is public AND exported |
| Generic rescue | Specific exception types available |
| Nested case/cond | More than 2 levels deep |

## When to Load References

- Reviewing module/function naming → code-style.md
- Reviewing with/case/cond statements → pattern-matching.md
- Reviewing GenServer/Supervisor code → otp-basics.md
- Reviewing @doc/@moduledoc → documentation.md

## Gates — before reporting

Do these **in order** for the review batch. 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 category you use (unused, validation, security, performance, etc.). **Pass:** For every substantive finding, you can name which protocol subsection you satisfied or state **N/A** with reason (pure style).
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. **Claims backed by artifacts** — For assertions like unused code, missing validation, or security risk, **Pass:** You attach the supporting artifact (e.g. search results, file read scope) or downgrade the item to an explicit **question** / **uncertain** with what you did not verify.

## 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установок elixir-expert VoltAgent Субагент elixir-expert для задач с Elixir и OTP: процессы, супервизия, отказоустойчивость, Phoenix. Анализирует границы выполнения, находит корни проблем и предлагает минимальные безопасные изменения. CX Codex ★ 6 505звёзд репо elixir Mindrally Задаёт агенту стиль работы с Elixir и Phoenix: функциональные паттерны, Ecto, LiveView, OTP. Используется в проектах на BEAM. CX Codex +1 881установок elixir-pro Seth Hobson Субагент elixir-pro для Claude Code помогает проектировать OTP-приложения и писать код на Elixir. Подключается к задачам рефакторинга, Phoenix LiveView и оптимизации BEAM. CX Codex ★ 42 780звёзд репо elixir-ecto-patterns TheBushidoCollective Скилл elixir-ecto-patterns для Claude Code подсказывает агенту, как писать код на Ecto: схемы, changesets, запросы, связи и транзакции. Описывает работу с базой в приложении на Elixir. CX Codex +1 121установок elixir-antipatterns tsardinasGitHub Скилл elixir-antipatterns для Claude Code содержит восемь антипаттернов Elixir и Phoenix для код-ревью и рефакторинга, включая N+1 в Ecto и логику в LiveView. CX Codex +1 194установок

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

Весь набор →
healthkit-code-review Скилл healthkit-code-review для Claude Code разбирает код с HealthKit по шагам: авторизацию, запросы, observer-запросы и фоновую доставку. Проверяет работу приложения с данными о здоровье. CX Codex +1 134установок cloudkit-code-review Скилл cloudkit-code-review проверяет Swift-код на ошибки работы с CloudKit: зоны, батчи, обработку CKErrorPartialFailure и лимиты CKAsset. CX Codex +1 127установок prometheus-go-code-review Скилл prometheus-go-code-review для Claude Code проверяет Prometheus-метрики в Go: типы, лейблы, имена и регистрацию. Ревьюирует код с prometheus/client_golang. CX Codex +1 126установок review-skill-improver Скилл review-skill-improver для Claude Code анализирует журнал отзывов о код-ревью и предлагает правки к скиллам. Выявляет повторяющиеся причины отказов по оценкам ACCEPT и REJECT. CX Codex +1 125установок app-intents-code-review Скилл app-intents-code-review проводит ревью кода Swift с фреймворком App Intents, проверяя таймауты, локализацию фраз и совместимость версий iOS. CX Codex +1 124установок review-feedback-schema Скилл review-feedback-schema для Claude Code задаёт CSV-схему результатов код-ревью и помогает оценивать качество проверок. Ведёт журнал решений по найденным проблемам. CX Codex +1 124установок combine-code-review Скилл combine-code-review проверяет код на Combine на ошибки в подписках, операторах, управлении памятью и обработке ошибок. Пригодится перед ревью Swift-кода с Combine. CX Codex +1 123установок receive-feedback Скилл receive-feedback разбирает замечания из код-ревью по фактам, а не из вежливости: каждый пункт проверяется по коду, получает вердикт с доказательством и только потом правится. CX Codex +1 123установок

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

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