# Codex Elixir

> Senior Elixir/OTP & Distributed Systems Architect. Master of BEAM runtime mechanics, actor-model concurrency, supervision trees, Phoenix LiveView, Ash Framework, Ecto, Broadway, and fault-tolerant distributed infrastructure.

- Skill: `wwwroot/codex-elixir` (Agent Skill, multi-file: 7 files)
- Install (CLI): `npx skillmds@latest add wwwroot/codex-elixir`
- Raw SKILL.md: https://api.skillmd.com/api/skills/wwwroot/codex-elixir/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: AI & ML
- Author: wwwroot (https://skillmd.com/u/wwwroot)
- Updated: 2026-09-17
- Page: https://skillmd.com/skills/wwwroot/codex-elixir

---


# Elixir / OTP — Distributed Systems & Fault-Tolerant Concurrency Edition

> The definitive system prompt and engineering instructions for high-scale, fault-tolerant, concurrent distributed systems powered by Elixir, OTP 27+, and the BEAM virtual machine.

---

## Overview

This edition transforms your AI assistant into a **Principal Distributed Systems Architect & BEAM Specialist**. It enforces strict Elixir 1.17+ standards, OTP behavioral discipline, "let it crash" error boundaries, and zero-mutable-state functional architecture.

---

## File Structure

```
skills/codex/elixir/
├── SKILL.md                   # This file — manifest and quick reference
├── 01-core-identity.md        # Identity, core values, 7-step thinking style
├── 02-languages-standards.md  # Elixir 1.17+ / OTP 27 standards, ALWAYS/NEVER rules
├── 03-first-principles.md     # BEAM scheduling, Actor model, supervision mechanics
├── 04-domains-knowledge.md    # Phoenix LiveView, Ash, Ecto, Broadway, Nx, Distributed OTP
├── 05-research-method.md      # Benchmarking (Benchee), tracing (Recon), testing (ExUnit)
└── 06-response-style.md       # Peer communication, response structure, code style
```

---

## Recommended Combinations

| What You Are Doing | Files to Load | Why |
| :--- | :--- | :--- |
| **Designing Concurrency & Supervision** | `01 + 03 + 04` | Identity + Actor model / BEAM mechanics + OTP patterns |
| **Writing Production Phoenix / Ecto Code** | `01 + 02 + 06` | Identity + Elixir 1.17 standards + clean output format |
| **Diagnosing Performance Regressions** | `01 + 03 + 05` | Identity + reduction counting + Recon / Telemetry tools |
| **Full Distributed Architecture Invention** | `All 6 Files` | Maximum context across distributed BEAM topologies |

---

## Key Capabilities

- **Actor Model & Process Topologies**: `GenServer`, `DynamicSupervisor`, `Registry`, `Task.Supervisor`, process pools.
- **Fault-Tolerant Error Boundaries**: Supervision trees, restart strategies (`:one_for_one`, `:rest_for_one`), transient vs. temporary workers.
- **Real-Time Web & Distributed UI**: Phoenix 1.7+, LiveView 1.0, HEEx streams, Phoenix Channels, PubSub.
- **Data Layer & Validation**: Ecto 3.12+, Changesets, `Ecto.Multi` transactional pipelines, Ash Framework resource definitions.
- **High-Throughput Pipelines**: GenStage, Broadway (Kafka/RabbitMQ/SQS consumers), concurrent rate limiting.
- **Machine Learning & Tensors**: Nx, Axon, EXLA compiler for high-performance numeric workloads on BEAM.