elixir

Files (7)

• SKILL.md
• elixir-advanced.md · references/
• elixir-ecto-advanced.md · references/
• elixir-fundamentals.md · references/
• elixir-otp.md · references/
• elixir-testing-exunit.md · references/
• phoenix-ecto.md · references/

SKILL.md (first lines)

# Elixir

## Purpose
Build fault-tolerant, concurrent applications with Elixir/OTP — Phoenix web layer, LiveView interactivity, Ecto persistence, supervision trees, process architecture.

## Agent Protocol

### Trigger
User request includes: `Elixir`, `Phoenix`, `Phoenix LiveView`, `OTP`, `BEAM`, `Elixir macros`, `Ecto`, `mix`, `phx.gen`, `Supervisor`, `GenServer`, `Phoenix channels`, `Phoenix PubSub`, `Elixir processes`, `iex`.

### Input Context
- Framework (Phoenix, Phoenix LiveView, bare Elixir)
- Persistence (Ecto with PostgreSQL, Ecto with SQLite, ETS)
- State management (GenServer, Agent, ETS, Phoenix PubSub)
- Deployment (Elixir releases, Docker, Gigalixir, Fly.io)

### Output Artifact
Phoenix project structure, OTP supervision tree, Ecto schema, LiveView module, router config.

### Response Format
Produce artifact directly. No preamble, no postamble, no explanations. No filler, no hedging, no transitions. Strip articles a/an/the where unambiguous. Compress output — why use many token when few do trick.

### Completion Criteria
- Phoenix project generated with mix phx.new
- Contexts separated by domain boundary
- Ecto schemas with proper associations
- LiveView with state management and event handling
- Supervision tree with appropriate restart strategy

### Max Response Length
4096 tokens

## Workflow

### Step 1: Phoenix Project Setup

```bash
# Install Phoenix
mix archive.install hex phx_new

# Create new Phoenix app
mix phx.new my_app --database postgres
mix phx.new my_app --database sqlite3  # Alternative

# Setup database
mix ecto.create
mix ecto.migrate

# Start server
mix phx.server
```

```
my_app/
  lib/
    my_app/
      application.ex         # OTP application start
      repo.ex                # Ecto Repo
      accounts.ex            # Context module (public API)
      accounts/              # Context internals
        user.ex              # Ecto schema
        user_notifier.ex
        user_token.ex
      catalog.ex
      catalog/
        product.ex
        category.ex
      store.ex               # Context: orders
      store/
        order.ex
        line_item.ex
      mailer.ex              # Swoosh mailer
    my_app_web/              # Web layer (separate namespace MyAppWeb)
      endpoint.ex
      router.ex
      controllers/
        user_session_controller.ex
      live/
        product_live/
          index.ex
          show.ex
      components/
        core_components.ex
        layouts.ex
    my_app.ex
    my_app_web.ex
  priv/
    repo/
      migrations/
        20250101000000_create_users.exs
  config/
    config.exs
    dev.exs
    prod.exs
    runtime.exs
  mix.exs
```

### Step 2: Ecto Schema and Migration

```elixir
# priv/repo/migrations/20250101000000_create_users.exs
defmodule MyApp.Repo.Migrations.CreateUsers do
  use Ecto.Migration

  def change do
    create table(:users, primary_key: false) do
      add :id, :uuid, primary_key: true, default: fragment("gen_random_uuid()")
      add :email, :string, null: false
      add :username, :string, null: false
      add :hashed_password, :string, null: false
      add :role, :string, default: "user"
      add :confirmed_at, :naive_datetime
      add :deleted_at, :naive_datetime
      timestamps()
    end

    create unique_index(:users, [:email])
    create unique_index(:users, [:username])

From j4flmao/agent-skills, MIT.

More from j4flmao/agent-skills