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

elixir-ecto-patterns — скилл для Claude Code

Скилл elixir-ecto-patterns для Claude Code подсказывает агенту, как писать код на Ecto: схемы, changesets, запросы, связи и транзакции. Описывает работу с базой в приложении на Elixir.

Apache-2.0 121 установок ★ 201 обновлён 2026-09-08

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

Что делает elixir-ecto-patterns

Скилл описывает, как писать код Ecto: схемы с полями и связями, changesets с валидациями, запросы через Ecto.Query и пайпы, прелоады, агрегаты с group_by, транзакции через Repo.transaction и Ecto.Multi. Отдельно разобраны встроенные схемы и свои типы на Ecto.Type.

Внутри один SKILL.md с примерами на Elixir — от has_many/belongs_to до update_all и cast_embed. Агенту разрешены только Bash и Read, так что правки в файлы проектов он этим скиллом не внесёт.

В frontmatter стоит user-invocable: false: слэш-команды нет, скилл подхватывается по описанию, когда речь заходит о базе в приложении на Elixir. Поэтому в списке команд его искать бесполезно.

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

  • объявить схему с полями, связями и timestamps()
  • собрать changeset с проверкой формата и уникальности email
  • написать запрос с фильтрами, сортировкой и limit
  • загрузить связи через preload вместе с join
  • обернуть вставку пользователя и поста в одну транзакцию через Ecto.Multi

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

  • Опиши схему User с полями name, email и связью has_many с постами.
  • Проверь мой changeset для Post и добавь валидацию длины заголовка.
  • Перепиши выборку активных пользователей старше 18 на пайп-синтаксис Ecto.

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

1Через Skills CLI (Vercel)

npx skills add TheBushidoCollective/han --skill elixir-ecto-patterns -a claude-code

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

~/.claude/skills/elixir-ecto-patterns/SKILL.md

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

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

Вопросы об elixir-ecto-patterns

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

Выполните npx skills add TheBushidoCollective/han --skill elixir-ecto-patterns -a claude-code. Файл скилла появится в ~/.claude/skills/elixir-ecto-patterns/SKILL.md.

Что делает elixir-ecto-patterns?

Даёт агенту образцы кода Ecto: объявление схем, changesets с проверками, запросы, прелоады и транзакции. Работает в проектах на Elixir, где данные идут через Ecto.

Почему скилла нет среди слэш-команд?

В его frontmatter стоит user-invocable: false, вручную его не вызвать. Агент подключает скилл сам, когда задача касается Ecto.

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

SKILL.md · Apache-2.0
---
name: elixir-ecto-patterns
user-invocable: false
description: Use when Elixir Ecto patterns including schemas, changesets, queries, and transactions. Use when building database-driven Elixir applications.
allowed-tools:
  - Bash
  - Read
---

# Elixir Ecto Patterns

Master Ecto, Elixir's database wrapper and query generator. This skill
covers schemas, changesets, queries, associations, and transactions for
building robust database applications.

## Schema Definition

```elixir
defmodule MyApp.User do
  use Ecto.Schema
  import Ecto.Changeset

  schema "users" do
    field :name, :string
    field :email, :string
    field :age, :integer
    field :is_active, :boolean, default: true
    field :role, Ecto.Enum, values: [:user, :admin, :moderator]

    has_many :posts, MyApp.Post
    belongs_to :organization, MyApp.Organization

    timestamps()
  end

  def changeset(user, attrs) do
    user
    |> cast(attrs, [:name, :email, :age, :is_active, :role])
    |> validate_required([:name, :email])
    |> validate_format(:email, ~r/@/)
    |> validate_number(:age, greater_than: 0, less_than: 150)
    |> unique_constraint(:email)
  end
end
```

## Changeset Validations

```elixir
defmodule MyApp.Post do
  use Ecto.Schema
  import Ecto.Changeset

  schema "posts" do
    field :title, :string
    field :body, :text
    field :published, :boolean, default: false
    field :tags, {:array, :string}, default: []

    belongs_to :user, MyApp.User

    timestamps()
  end

  def changeset(post, attrs) do
    post
    |> cast(attrs, [:title, :body, :published, :tags, :user_id])
    |> validate_required([:title, :body, :user_id])
    |> validate_length(:title, min: 3, max: 100)
    |> validate_length(:body, min: 10)
    |> foreign_key_constraint(:user_id)
  end

  def publish_changeset(post) do
    post
    |> change(published: true)
  end
end
```

## Basic Queries

```elixir
import Ecto.Query

# Get all users
Repo.all(User)

# Get user by ID
Repo.get(User, 1)
Repo.get!(User, 1)  # Raises if not found

# Get by specific field
Repo.get_by(User, email: "[email protected]")

# Filter with where clause
query = from u in User, where: u.age > 18
Repo.all(query)

# Select specific fields
query = from u in User, select: {u.id, u.name}
Repo.all(query)

# Order results
query = from u in User, order_by: [desc: u.inserted_at]
Repo.all(query)

# Limit and offset
query = from u in User, limit: 10, offset: 20
Repo.all(query)
```

## Complex Queries

```elixir
# Combining multiple conditions
query =
  from u in User,
    where: u.is_active == true,
    where: u.age >= 18,
    order_by: [desc: u.inserted_at],
    limit: 10

Repo.all(query)

# Using pipe syntax
User
|> where([u], u.is_active == true)
|> where([u], u.age >= 18)
|> order_by([u], desc: u.inserted_at)
|> limit(10)
|> Repo.all()

# Dynamic queries
def filter_users(params) do
  User
  |> filter_by_name(params["name"])
  |> filter_by_age(params["min_age"])
  |> Repo.all()
end

defp filter_by_name(query, nil), do: query
defp filter_by_name(query, name) do
  where(query, [u], ilike(u.name, ^"%#{name}%"))
end

defp filter_by_age(query, nil), do: query
defp filter_by_age(query, min_age) do
  where(query, [u], u.age >= ^min_age)
end
```

## Associations and Preloading

```elixir
# Preload associations
user = Repo.get(User, 1) |> Repo.preload(:posts)

# Preload nested associations
user = Repo.get(User, 1) |> Repo.preload([posts: :comments])

# Query with preload
query = from u in User, preload: [:posts, :organization]
Repo.all(query)

# Custom preload query
posts_query = from p in Post, where: p.published == true

query = from u in User, preload: [posts: ^posts_query]
Repo.all(query)

# Join and preload
query =
  from u in User,
    join: p in assoc(u, :posts),
    where: p.published == true,
    preload: [posts: p]

Repo.all(query)
```

## Aggregations and Grouping

```elixir
# Count records
Repo.aggregate(User, :count)

# Count with condition
query = from u in User, where: u.is_active == true
Repo.aggregate(query, :count)

# Other aggregations
Repo.aggregate(User, :avg, :age)
Repo.aggregate(User, :sum, :age)
Repo.aggregate(User, :max, :age)

# Group by
query =
  from u in User,
    group_by: u.role,
    select: {u.role, count(u.id)}

Repo.all(query)

# Group with having
query =
  from u in User,
    group_by: u.role,
    having: count(u.id) > 5,
    select: {u.role, count(u.id)}

Repo.all(query)
```

## Inserting and Updating

```elixir
# Insert with changeset
attrs = %{name: "John", email: "[email protected]", age: 30}

%User{}
|> User.changeset(attrs)
|> Repo.insert()

# Insert without changeset
Repo.insert(%User{name: "Jane", email: "[email protected]"})

# Update
user = Repo.get(User, 1)

user
|> User.changeset(%{age: 31})
|> Repo.update()

# Update all
query = from u in User, where: u.is_active == false
Repo.update_all(query, set: [is_active: true])

# Delete
user = Repo.get(User, 1)
Repo.delete(user)

# Delete all
query = from u in User, where: u.is_active == false
Repo.delete_all(query)
```

## Transactions

```elixir
# Basic transaction
Repo.transaction(fn ->
  user = Repo.insert!(%User{name: "Alice"})
  Repo.insert!(%Post{title: "First post", user_id: user.id})
end)

# Multi for complex transactions
alias Ecto.Multi

Multi.new()
|> Multi.insert(:user, User.changeset(%User{}, user_attrs))
|> Multi.insert(:post, fn %{user: user} ->
  Post.changeset(%Post{}, Map.put(post_attrs, :user_id, user.id))
end)
|> Multi.run(:send_email, fn _repo, %{user: user} ->
  send_welcome_email(user)
end)
|> Repo.transaction()
```

## Embedded Schemas

```elixir
defmodule MyApp.Address do
  use Ecto.Schema
  import Ecto.Changeset

  embedded_schema do
    field :street, :string
    field :city, :string
    field :state, :string
    field :zip, :string
  end

  def changeset(address, attrs) do
    address
    |> cast(attrs, [:street, :city, :state, :zip])
    |> validate_required([:city, :state])
  end
end

defmodule MyApp.User do
  use Ecto.Schema
  import Ecto.Changeset

  schema "users" do
    field :name, :string
    embeds_one :address, MyApp.Address

    timestamps()
  end

  def changeset(user, attrs) do
    user
    |> cast(attrs, [:name])
    |> cast_embed(:address, required: true)
  end
end
```

## Custom Ecto Types

```elixir
defmodule MyApp.Encrypted do
  use Ecto.Type

  def type, do: :binary

  def cast(value) when is_binary(value), do: {:ok, value}
  def cast(_), do: :error

  def dump(value) when is_binary(value) do
    {:ok, encrypt(value)}
  end

  def load(value) when is_binary(value) do
    {:ok, decrypt(value)}
  end

  defp encrypt(value) do
    # Encryption logic
    value
  end

  defp decrypt(value) do
    # Decryption logic
    value
  end
end

# Usage in schema
schema "users" do
  field :secret, MyApp.Encrypted
end
```

## When to Use This Skill

Use elixir-ecto-patterns when you need to:

- Build database-backed Elixir applications
- Define schemas and data models with validations
- Write complex database queries with Ecto's DSL
- Manage database relationships and associations
- Handle data transformations with changesets
- Implement transactions for data consistency
- Work with PostgreSQL, MySQL, or other databases
- Build Phoenix applications with database access
- Create robust data validation layers

## Best Practices

- Always use changesets for data validation
- Preload associations to avoid N+1 queries
- Use transactions for multi-step database operations
- Leverage Ecto.Multi for complex transaction logic
- Keep schemas focused and avoid god objects
- Use virtual fields for computed or temporary data
- Index foreign keys and frequently queried fields
- Use fragments for complex SQL when needed
- Write composable query functions
- Test database constraints and validations

## Common Pitfalls

- Not preloading associations (N+1 query problem)
- Forgetting to validate required fields
- Not using transactions for related operations
- Hardcoding queries instead of composing them
- Ignoring database constraints in schemas
- Not handling changeset errors properly
- Overusing embedded schemas for relational data
- Missing indexes on foreign keys
- Not using Repo.transaction for multi-step operations
- Exposing raw Ecto queries in business logic

## Resources

- [Ecto Documentation](https://hexdocs.pm/ecto/)
- [Ecto Query Guide](https://hexdocs.pm/ecto/Ecto.Query.html)
- [Ecto Changeset](https://hexdocs.pm/ecto/Ecto.Changeset.html)
- [Phoenix with Ecto](https://hexdocs.pm/phoenix/ecto.html)
- [Ecto Best Practices](https://hexdocs.pm/ecto/getting-started.html)

© TheBushidoCollective · Apache-2.0 · TheBushidoCollective/han

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

Все скиллы по теме «Языки программирования» →
ecto-patterns Claude MPM Team Скилл ecto-patterns для Claude Code с паттернами Ecto для Phoenix/Elixir-приложений. Схемы, changeset'ы, миграции, транзакции, пагинация, мультиарендность и тесты — подсказки по каждой теме разворачиваются прямо в контексте агента. CX Codex +1 352установок elixir Mindrally Задаёт агенту стиль работы с Elixir и Phoenix: функциональные паттерны, Ecto, LiveView, OTP. Используется в проектах на BEAM. CX Codex +1 881установок 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-antipatterns tsardinasGitHub Скилл elixir-antipatterns для Claude Code содержит восемь антипаттернов Elixir и Phoenix для код-ревью и рефакторинга, включая N+1 в Ecto и логику в LiveView. CX Codex +1 194установок 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звёзд репо

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

Весь набор →
reactflow-fundamentals Скилл reactflow-fundamentals помогает создавать блок-схемы, редакторы пайплайнов и графы на React Flow. Подсказывает агенту готовые структуры узлов, рёбер и элементов управления. CX Codex +1 138установок django-orm-patterns Скилл django-orm-patterns для Claude Code помогает проектировать модели и запросы Django ORM. Работает с приложениями, где есть база данных, связи и сложная выборка. CX Codex +1 136установок c-systems-programming Скилл c-systems-programming добавляет в ассистент паттерны системного программирования на C: работу с процессами, сигналами, пайпами и низкоуровневым вводом-выводом. CX Codex +1 134установок bdd-principles Скилл bdd-principles для Claude Code объясняет основы BDD, практику Three Amigos и сценарии как живую документацию. Помогает согласовывать требования через конкретные примеры до разработки. CX Codex +1 133установок storybook-play-functions Скилл storybook-play-functions учит агента писать interaction-тесты внутри историй Storybook через функции play и библиотеку @storybook/test. CX Codex +1 119установок tensorflow-neural-networks Скилл tensorflow-neural-networks для Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI и OpenCode — строит и обучает нейронные сети через Keras API и низкоуровневые реализации TensorFlow. CX Codex +1 116установок atomic-design-integration Скилл atomic-design-integration интегрирует методологию Atomic Design в React, Vue и Angular: структура папок, barrel exports, типизированные компоненты и хуки. CX Codex +1 114установок reactflow-custom-nodes Скилл reactflow-custom-nodes учит агента создавать кастомные узлы, рёбра и хендлы для React Flow: настраиваемые компоненты, изменяемые размеры, тулбары. CX Codex +1 112установок

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

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