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

elixir-antipatterns — скилл для Claude Code: разбор и установка

Скилл elixir-antipatterns для Claude Code содержит восемь антипаттернов Elixir и Phoenix для код-ревью и рефакторинга, включая N+1 в Ecto и логику в LiveView.

MIT 194 установок ★ 678 обновлён 2026-03-28

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

Что делает elixir-antipatterns

Скилл задаёт восемь строгих правил написания кода на Elixir и Phoenix. Он заставляет ассистента возвращать тегированные кортежи {:ok, value} и {:error, reason} вместо возврата nil или вызова исключений через raise. В сигнатурах функций требуется явно фиксировать типы ошибок через @spec.

В архитектурной части скилл запрещает размещать бизнес-логику внутри Phoenix LiveView: интерфейс остаётся тонким, а вычисления переносятся в контексты. Для запросов Ecto скилл требует устранять проблему N+1 с помощью Repo.preload/2 и следить за индексами в миграциях. В конструкциях with запрещено использовать прямое связывание = для операций, способных завершиться сбоем, а слишком длинные цепочки шагов скилл предписывает делить на связные функции.

Архитектурные проверки не заменяют статический анализ стиля: автор скилла прямо указывает использовать его в связке с mix format и Credo.

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

  • устранить N+1 запросы в Ecto через Repo.preload/2
  • вынести бизнес-логику из LiveView в контексты
  • заменить вызовы raise и nil на кортежи {:ok, _} и {:error, _}
  • предотвратить пропуск ошибок в конструкциях with через стрелочный оператор

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

  • Проверь этот модуль на антипаттерны Elixir и предложи рефакторинг для LiveView
  • Найди в коде запросов Ecto проблему N+1 и перепиши с preload

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

1Через Skills CLI (Vercel)

npx skills add Gentleman-Programming/Gentleman-Skills --skill elixir-antipatterns -a claude-code

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

~/.claude/skills/elixir-antipatterns/SKILL.md

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

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

Вопросы об elixir-antipatterns

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

Выполните в терминале команду npx skills add Gentleman-Programming/Gentleman-Skills --skill elixir-antipatterns -a claude-code.

Что проверяет скилл elixir-antipatterns?

Он проверяет восемь шаблонов: возврат кортежей ошибок, спецификации @spec, изоляцию контекстов от LiveView, загрузку связей Ecto, связывание в with и утверждения в ExUnit.

Заменяет ли скилл линтер Credo?

Нет. Скилл регламентирует архитектурные решения и обработку ошибок, а стиль и форматирование кода автор рекомендует проверять утилитами mix format и Credo.

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

SKILL.md · MIT
---
name: elixir-antipatterns
description: >
  Core catalog of 8 critical Elixir/Phoenix anti-patterns covering error handling,
  separation of concerns, Ecto queries, and testing. 
  Trigger: During Elixir code review, refactoring sessions, or when writing Phoenix/Ecto code.
metadata:
  author: tsardinasGitHub
  version: "1.0"
---

# Elixir Anti-Patterns

Critical anti-patterns that compromise robustness and maintainability in Elixir/Phoenix applications.

> **Complement with**: `mix format` and `Credo` for style enforcement  
> **Extended reference**: See `EXTENDED.md` for 40+ patterns and deep-dive examples

---

## When to Use

**Topics:** Error handling (3 patterns) • Architecture (2 patterns) • Performance (2 patterns) • Testing (1 pattern)

Load this skill when:
- Writing Elixir modules and functions
- Working with Phoenix Framework (Controllers, LiveView)
- Building Ecto schemas and database queries
- Implementing BEAM concurrency (Task, GenServer)
- Handling errors with tagged tuples
- Writing tests with ExUnit

---

## Critical Patterns

Quick reference to the 8 core patterns this skill enforces:

1. **Tagged Tuples**: Return `{:ok, value} | {:error, reason}` instead of `nil` or exceptions
2. **Explicit @spec**: Document error cases in function signatures
3. **Context Separation**: Business logic in contexts, not LiveView
4. **Preload Associations**: Use `Repo.preload/2` to avoid N+1 queries
5. **with Arrow Binding**: Use `<-` for all failable operations in `with`
6. **Database Indexes**: Index frequently queried columns
7. **Test Assertions**: Every test must assert expected behavior
8. **Cohesive Functions**: Group `with` chains >4 steps into functions

> See `## Anti-Patterns` section below for detailed ❌ BAD / ✅ CORRECT code examples.

---

## Code Examples

### Example 1: Error Handling with Tagged Tuples

```elixir
# ✅ CORRECT - Errors as values, explicit in @spec
defmodule UserService do
  @spec fetch_user(String.t()) :: {:ok, User.t()} | {:error, :not_found}
  def fetch_user(id) do
    case Repo.get(User, id) do
      nil -> {:error, :not_found}
      user -> {:ok, user}
    end
  end
end

# ❌ BAD - Exceptions for business errors
def fetch_user(id) do
  Repo.get(User, id) || raise "User not found"
end
```

### Example 2: Phoenix LiveView with Context Separation

```
Architecture Layers:
  User Request → LiveView (UI only) → Context (business logic) → Schema/Repo (data)
               ↓                    ↓                           ↓
           handle_event()     Accounts.create_user()      Repo.insert()
```

```elixir
# ✅ CORRECT - Thin LiveView, logic in context
defmodule MyAppWeb.UserLive.Index do
  use MyAppWeb, :live_view
  
  def handle_event("create", params, socket) do
    case Accounts.create_user(params) do
      {:ok, user} -> {:noreply, redirect(socket, to: ~p"/users/#{user}")}
      {:error, changeset} -> {:noreply, assign(socket, changeset: changeset)}
    end
  end
end

# ❌ BAD - Business logic in LiveView
def handle_event("create", %{"user" => params}, socket) do
  if String.length(params["name"]) < 3 do
    {:noreply, put_flash(socket, :error, "Too short")}
  else
    case Repo.insert(User.changeset(%User{}, params)) do
      {:ok, user} -> send_email(user); redirect(socket)
    end
  end
end
```

### Example 3: Ecto N+1 Query Optimization

```elixir
# ✅ CORRECT - Preload associations (2 queries total)
users = User |> Repo.all() |> Repo.preload(:posts)
Enum.map(users, fn user -> process(user, user.posts) end)

# Note: For complex filtering (e.g., WHERE posts.status = 'published'),
# use join + preload in the query itself. See EXTENDED.md for advanced patterns.

# ❌ BAD - Query in loop (101 queries for 100 users)
users = Repo.all(User)
Enum.map(users, fn user ->
  posts = Repo.all(from p in Post, where: p.user_id == ^user.id)
  {user, posts}
end)
```

---

## Anti-Patterns

### Error Management

#### Don't: Use `raise` for Business Errors

```elixir
# ❌ BAD
def fetch_user(id) do
  Repo.get(User, id) || raise "User not found"
end

# ✅ CORRECT
@spec fetch_user(String.t()) :: {:ok, User.t()} | {:error, :not_found}
def fetch_user(id) do
  case Repo.get(User, id) do
    nil -> {:error, :not_found}
    user -> {:ok, user}
  end
end
```

**Why**: `@spec` documents errors, pattern matching forces explicit handling.

---

#### Don't: Return `nil` for Errors

```elixir
# ❌ BAD - No context on failure
def find_user(email), do: Repo.get_by(User, email: email)

# ✅ CORRECT - Explicit error reason
@spec find_user(String.t()) :: {:ok, User.t()} | {:error, :not_found}
def find_user(email) do
  case Repo.get_by(User, email: email) do
    nil -> {:error, :not_found}
    user -> {:ok, user}
  end
end
```

---

#### Don't: Use `=` Inside `with` for Failable Operations

```elixir
# ❌ BAD - Validate errors silenced
with {:ok, user} <- fetch_user(id),
     validated = validate(user),  # ← Doesn't check for {:error, _}
     {:ok, saved} <- save(validated) do
  {:ok, saved}
end

# ✅ CORRECT - All operations use <-
with {:ok, user} <- fetch_user(id),
     {:ok, validated} <- validate(user),
     {:ok, saved} <- save(validated) do
  {:ok, saved}
end
```

---

### Architecture & Boundaries

#### Don't: Put Business Logic in LiveView

```elixir
# ❌ BAD - Validation in view
def handle_event("create", %{"user" => params}, socket) do
  if String.length(params["name"]) < 3 do
    {:noreply, put_flash(socket, :error, "Too short")}
  else
    case Repo.insert(User.changeset(%User{}, params)) do
      {:ok, user} -> redirect(socket)
    end
  end
end

# ✅ CORRECT - Delegate to context
def handle_event("create", params, socket) do
  case Accounts.create_user(params) do
    {:ok, user} -> {:noreply, redirect(socket, to: ~p"/users/#{user}")}
    {:error, changeset} -> {:noreply, assign(socket, changeset: changeset)}
  end
end
```

**Why**: Contexts testable without Phoenix, logic reusable.

---

#### Don't: Chain More Than 4 Steps in `with`

```elixir
# ❌ BAD - Too many responsibilities
with {:ok, a} <- step1(),
     {:ok, b} <- step2(a),
     {:ok, c} <- step3(b),
     {:ok, d} <- step4(c),
     {:ok, e} <- step5(d) do
  {:ok, e}
end

# ✅ CORRECT - Group into cohesive functions
with {:ok, validated} <- validate_and_fetch(id),
     {:ok, processed} <- process_business_rules(validated),
     {:ok, result} <- persist_and_notify(processed) do
  {:ok, result}
end
```

---

### Data & Performance

#### Don't: Query Inside Loops (N+1)

```elixir
# ❌ BAD - 101 queries for 100 users
users = Repo.all(User)
Enum.map(users, fn user ->
  posts = Repo.all(from p in Post, where: p.user_id == ^user.id)
end)

# ✅ CORRECT - 2 queries total
User |> Repo.all() |> Repo.preload(:posts)
```

**Impact**: 100 users with N+1 = 10 seconds vs 5ms with preload.

---

#### Don't: Query Without Indexes

```elixir
# ❌ BAD - No index on frequently queried column
# Migration:
create table(:users) do
  add :email, :string
end

# ✅ CORRECT - Add index
create table(:users) do
  add :email, :string
end
create unique_index(:users, [:email])
```

**Why**: Full table scan on 1M+ rows vs instant index lookup.

---

### Testing

#### Don't: Write Tests Without Assertions

```elixir
# ❌ BAD - What's being tested?
test "creates user" do
  UserService.create_user(%{name: "Juan"})
end

# ✅ CORRECT - Assert expected behavior
test "creates user successfully" do
  assert {:ok, user} = UserService.create_user(%{name: "Juan"})
  assert user.name == "Juan"
end
```

---

## Quick Reference

| Situation | Anti-Pattern | Correct Pattern |
|-----------|--------------|-----------------|
| **Error handling** | `raise "Not found"` | `{:error, :not_found}` |
| **Missing data** | Return `nil` | `{:error, :not_found}` |
| **Business logic** | In LiveView | In context modules |
| **Associations** | `Enum.map` + `Repo.get` | `Repo.preload` |
| **with chains** | `validated = fn()` | `{:ok, validated} <- fn()` |
| **Frequent queries** | No index | `create index(:table, [:column])` |
| **Testing** | No assertions | `assert` expected behavior |
| **Complex logic** | 6+ step `with` | Group into 3 functions |

---

## Resources

- [Elixir Style Guide](https://hexdocs.pm/elixir/naming-conventions.html)
- [Phoenix Contexts](https://hexdocs.pm/phoenix/contexts.html)
- [Ecto Query Performance](https://hexdocs.pm/ecto/Ecto.Query.html)
- [ExUnit Best Practices](https://hexdocs.pm/ex_unit/ExUnit.html)
- **Extended patterns**: See `EXTENDED.md` for 40+ anti-patterns

© tsardinasGitHub · MIT · Gentleman-Programming/Gentleman-Skills

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

Все скиллы по теме «Бэкенд и API» →
elixir-expert VoltAgent Community Субагент elixir-expert для Claude Code разбирает архитектуру Elixir-проектов и помогает менять код с опорой на OTP, Phoenix и Ecto. Помогает проектировать процессы, обрабатывать сбои и покрывать функции тестами. CX Codex 167установок elixir-engineer-guidelines-cursorrules-prompt-file PatrickJS Правило elixir-engineer-guidelines-cursorrules-prompt-file для Cursor задаёт контекст опытного Elixir-инженера и формат сообщений об изменениях. Учитывает стек проектов на Phoenix и связанные технологии. CX Codex +1 ★ 41 178звёзд репо elixir Mindrally Задаёт агенту стиль работы с Elixir и Phoenix: функциональные паттерны, Ecto, LiveView, OTP. Используется в проектах на BEAM. CX Codex +1 881установок elixir-phoenix-docker-setup-cursorrules-prompt-fil PatrickJS Правило elixir-phoenix-docker-setup-cursorrules-prompt-fil настраивает Cursor под стек Elixir, Phoenix и Docker. Задаёт роль senior-инженера, генерацию коммитов по Conventional Commits и краткие ответы по префиксу «VV». CX Codex +1 ★ 41 178звёзд репо phoenix Mindrally Задаёт агенту правила кода на Elixir и Phoenix — LiveView, Ecto, контексты, тесты. Держит предсказуемый стиль в проекте на Phoenix. CX Codex +1 763установок Phoenix App taste f Промпт Phoenix App taste для ChatGPT, Claude.ai и Claude Code, задающий стандарты разработки на Elixir и Phoenix. Устанавливает правила архитектуры, работы с базой данных и тестирования в новых проектах. GP ChatGPT ★ 178 201звёзд репо

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

Весь набор →
angular-core Скилл angular-core учит агента современным паттернам Angular: standalone-компоненты, сигналы вместо хуков, zoneless-режим и встроенный control flow. CX Codex +1 230установок jira-task Скилл jira-task автоматизирует создание задач в Jira по стандарту Prowler. Генерирует структурированные баги, фичи и рефакторинги с правильными заголовками, критериями приёма и разбивкой по компонентам. CX Codex +1 217установок github-pr Скилл github-pr задаёт правила оформления пулл-реквестов по стандарту Conventional Commits и готовит вызовы gh pr create без рутины. CX Codex +1 205установок playwright Скилл для написания E2E-тестов на Playwright с паттерном Page Objects. Помогает строить тесты через исследование реального UI с MCP-инструментами, затем кодировать селекторы и проверки на основе точных данных. CX Codex +1 194установок nextjs-15 Скилл задаёт паттерны работы с App Router в Next.js 15: маршрутизацию, Server Actions, параллельную загрузку данных и настройку middleware. CX Codex +1 185установок electron Организует структуру проекта на Electron, настраивает безопасный IPC через contextBridge и даёт типизированные шаблоны взаимодействия между процессами. CX Codex +1 175установок skill-creator Скилл skill-creator для Claude Code создаёт новые скиллы по спецификации Agent Skills. Оформляет повторяемые паттерны, проектные правила и сложные рабочие процессы. CX Codex +1 171установок django-drf Скилл django-drf помогает проектировать REST API на Django: ViewSet, сериализаторы, фильтры и тесты. Пригодится при сборке нового API. CX Codex +1 162установок

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

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