igmarin/elixir-phoenix-skills
Curated library of 38 atomic skills, 7 personas, and 1 orchestrator for Elixir and Phoenix development. Organized by category: fundamentals, phoenix, database, testing, auth, infrastructure, quality, security, integrations, tooling, frameworks, personas, and orchestration. Covers core Elixir patterns, Phoenix LiveView, Ecto, OTP, Oban, testing, security, deployment, real-time, and modern tooling (Req, Swoosh, Cachex, Broadway, Ash).
73
91%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Advisory
Suggest reviewing before use
Elixir Phoenix Skills
A curated library of public Elixir/Phoenix agent skills — 38 atomic skills, 7 personas, and 1 entry-point orchestrator that teach AI tools how to write idiomatic Elixir code, test Phoenix applications, and follow production-minded conventions.
The project is built around core Elixir principles:
Pattern matching over conditionals → Let it crash → Pipes for transformations → with for fallible operationsThese principles are encoded directly into the skills, so agents produce idiomatic Elixir code that follows the BEAM philosophy.
Part of the AI Skill Ecosystem
This repo is one of 6 in a composable AI skill ecosystem:
| Repo | Role |
|---|---|
ruby-core-skills | 15 shared Ruby skills + process discipline |
rails-agent-skills | 28 atomic skills + 9 personas |
elixir-phoenix-skills | 38 atomic skills + 7 personas + 1 orchestrator |
hanakai-yaku | 35 Hanami/dry-rb skills + 10 personas |
agnostic-planning-skills | 10 planning skills + 4 personas |
agent-mcp-runtime | Rust CLI runtime (pack resolution, MCP) |
See the Ecosystem Overview for the full architecture.
Supported agent environments
Official distribution
What are Agent Skills?
Agent Skills are a lightweight, open format for extending AI agent capabilities with specialized knowledge and workflows. At its core, a skill is a folder containing a SKILL.md file with metadata, instructions, and optionally assets/. This repository follows the Agent Skills standard:
npx skills add igmarin/elixir-phoenix-skillsWho This Is For
| Reader | What you get |
|---|---|
| Elixir developers | Agent instructions for common Elixir/Phoenix work: LiveView, Ecto, OTP, testing, security, and deployment. |
| Team leads | A repeatable workflow that makes AI-assisted Elixir work easier to review — tests, docs, and self-review are part of the process. |
| Junior developers | Step-by-step Elixir workflow guidance that explains what to do next instead of dumping generic code. |
| Senior developers | Opinionated guardrails for TDD, architecture, review, OTP patterns, performance, and production-safe changes. |
Skill Catalog
The library contains 46 skills total — 38 atomic skills, 7 personas, and 1 orchestrator — organized by category.
Atomic Skills
| Category | Skills | Path |
|---|---|---|
| Fundamentals | elixir-essentials, otp-essentials, typespec-dialyzer | skills/fundamentals/ |
| Phoenix | phoenix-liveview-essentials, liveview-streams, phoenix-scopes, phoenix-channels-essentials, phoenix-json-api, phoenix-pubsub-patterns, phoenix-uploads | skills/phoenix/ |
| Database | ecto-essentials, ecto-changeset-patterns, ecto-nested-associations | skills/database/ |
| Testing | testing-essentials, property-based-testing, benchee-profiling | skills/testing/ |
| Auth | phoenix-liveview-auth, phoenix-auth-customization, phoenix-authorization-patterns | skills/auth/ |
| Infrastructure | oban-essentials, broadway-data-pipelines, deployment-gotchas, telemetry-essentials, cachex-caching | skills/infrastructure/ |
| Quality | code-quality, credo-config, apply-phoenix-liveview-conventions, apply-phoenix-controller-conventions, code-review, refactor-code, respond-to-review, apply-ecto-conventions | skills/quality/ |
| Security | security-essentials | skills/security/ |
| Integrations | req-http-client, swoosh-emails, gettext-i18n | skills/integrations/ |
| Tooling | mix-tasks-generators | skills/tooling/ |
| Frameworks | ash-framework | skills/frameworks/ |
Personas (Workflow Orchestration)
Personas orchestrate multiple atomic skills into end-to-end workflows with hard gates, phases, and output formats:
| Persona | Phases | Purpose |
|---|---|---|
| elixir-skill-router | Triage → Delegate | Entry-point orchestrator that routes requests to the correct skill or persona |
| tdd | Context → Test → RED → GREEN → REFACTOR → Quality Gate | Full TDD cycle with test-first discipline |
| quality | Format → Credo → Dialyzer → Refactoring → Docs | Code quality loop before PR |
| setup | Elixir/Erlang → Deps → DB → CI/CD → Validate | Project setup and CI/CD configuration |
| bug-fix | Triage → Reproduce → Fix → Verify | Bug fixing with reproduction tests |
| background-job | Design → TDD → Retry/Discard → Failure Testing → Monitoring | Robust Oban job implementation |
| liveview | Contract → Test → Implementation → Quality | Full LiveView feature development |
| ecto-migration | Plan → Implement → Verify → Deploy | Safe migrations with expand-contract |
Assets
Key skills include assets/ with templates, checklists, and code snippets:
| Skill | Assets |
|---|---|
testing-essentials | spec_templates.md, tdd_checklist.md |
code-quality | refactoring_checklist.md |
security-essentials | security_checklist.md |
phoenix-liveview-essentials | liveview_test_template.md, component_test_template.md |
phoenix-liveview-auth | on_mount_template.ex |
ecto-essentials | migration_checklist.md, changeset_snippets.ex |
elixir-skill-router | skill-map.json |
How Skills Chain Together
Skills are designed to compose. A typical workflow chains from entry to quality gate:
elixir-skill-router → tdd → quality → PRCommon Chains
| Workflow | Skill chain |
|---|---|
| New feature | elixir-skill-router → tdd → quality |
| Bug fix | elixir-skill-router → bug-fix → quality |
| New LiveView page | liveview → tdd → quality |
| Background job | background-job → quality |
| Database change | ecto-migration → setup |
| Before PR | quality (standalone) |
| Project bootstrap | setup → tdd |
Per-skill Chaining
Every skill includes an Integration table showing predecessor and successor skills:
| Predecessor | This Skill | Successor |
|-------------|------------|----------|
| elixir-essentials | testing-essentials | code-quality |Installation
# Install all skills
npx skills add igmarin/elixir-phoenix-skills
# Or via GitHub CLI (v2.90.0+)
gh skill install igmarin/elixir-phoenix-skills
# Install a specific persona
gh skill install igmarin/elixir-phoenix-skills tdd --scope projectAcknowledgements
This repository adapts content from elixir-phoenix-guide by Joseph Morgan, licensed under MIT. See ACKNOWLEDGEMENTS.md for details.
Contributing
When contributing skills:
- Keep generated artifacts in English unless a user explicitly asks for another language.
- Follow the established skill format with RULES sections and 3-column Integration tables.
- Include good/bad code examples for all major patterns.
- Add
assets/with templates, checklists, or snippets when the skill benefits from reusable artifacts. - Personas must include phases, hard gates, error recovery, and an output style section.
License
This project is licensed under the MIT License. See LICENSE for details.
- Workspace
- igmarin
- Visibility
- Public
- Created
- Last updated
- Publish Source
- CLI
- Badge
