Elixir Agent Tools plugin
Five short Elixir, Phoenix, Ecto, OTP and Oban skills for Claude Code and Codex, plus optional Mix checks.
- 192 ★ on the repository
- Last commit
- Apache-2.0
Extended access
Why this level
- The mix-format, mix-compile and mix-credo plugins run Mix commands after every edit of `.ex` and `.exs` files.
- The skills themselves only instruct the agent.
Install
- Works in
Manual install
npx skills add georgeguimaraes/elixir-agent-tools --skill '*'The first command of the Installation section. Claude Code and Codex also have a plugin marketplace path.
Access and checks
How we reviewExtended accessThe tool runs code or makes network calls and only reads external data.
- The mix-format, mix-compile and mix-credo plugins run Mix commands after every edit of `.ex` and `.exs` files.
- The skills themselves only instruct the agent.
This is third-party code. Review the repository files before installing.
What it does
Elixir Agent Tools shapes how an agent approaches Elixir code. The skills are `elixir`, `phoenix`, `ecto`, `otp` and `oban`: functions and pattern matching, LiveView, Plug and channels, schemas, queries and migrations, processes and supervision, and jobs with retries and scheduling. An agent loads several at once when a task crosses areas, such as a LiveView form backed by an Ecto changeset. The author kept the skills short: each holds only instructions that change the agent's decision. Separate plugins run `mix format`, compilation with `--warnings-as-errors` and Credo after edits, and Expert adds code navigation and diagnostics in Claude Code.
Who it is for. Elixir developers using Claude Code or Codex who want the agent to follow language and Phoenix idioms instead of patterns from other languages.
Good fit when
- A nested `case` has to be rewritten with pattern matching and `with`.
- A LiveView filter must stay in sync with the URL.
- A page shows N+1 queries in Ecto.
- A GenServer has a bottleneck and needs supervision advice.
- Emails must be sent from an Oban job that retries on failure.
Not a fit when
- The project is not Elixir; the skills and Mix checks add nothing.
- The agent must get a detailed language reference; the skills are deliberately short.
- You need the Expert server in Codex; the elixir-lsp plugin targets Claude Code.
Example request
Rewrite this nested case with `with` and pattern matching the way Elixir code is usually written.Limitations
The skills work with no extra tools, while the Mix checks need Claude Code or Codex, Bash, Elixir with Mix and a Mix project. Credo must be in the project's dependencies. The elixir-lsp plugin runs only in Claude Code and needs Expert and Python 3. Do not install the plugin and `npx skills` together: skills would duplicate. In the 3.0 upgrade the skill names lost the -thinking suffix and the routing skill was removed, so explicit references in prompts need fixing. Hooks run Mix commands on your machine after every edit.
How to disable. For the plugin run `claude plugin uninstall elixir-dev@elixir-agent-tools` or the Codex equivalent. Skills installed through `npx skills` are removed from the agent's skills folder.
FAQ
How do I install Elixir Agent Tools?
Run `npx skills add georgeguimaraes/elixir-agent-tools --skill '*'` and choose your agent. The `-g` flag makes the skills available across projects.
Which skills are included?
Five: `elixir`, `phoenix`, `ecto`, `otp` and `oban`. The agent picks them by description and may load several for one task.
Do I need the plugin if I use npx skills?
No, they are alternative ways to install the same five skills. Use one of them, otherwise the skills duplicate.
What do mix-format, mix-compile and mix-credo do?
After edits to `.ex` and `.exs` files they run `mix format`, compilation with `--warnings-as-errors` and Credo. Each needs a Mix project.
What changed in version 3.0?
Skills lost the -thinking suffix, the `using-elixir-skills` router and startup hook were removed, the plugin is named `elixir-dev` and the marketplace `elixir-agent-tools`.
Discussion
No questions or reviews yet.
Related
PluginsSkills for commits, review and ZenTao plus a status line, gateway balance and session logs for Claude Code, Codex, OpenCode.
agent-toolkit offers generic skills for engineering tasks: from a ticket to a plan, tasks and a handover for review.
A Claude Code and Codex plugin with skills for code research, tests, refactoring and independent review of finished changes
The author's personal set: shared agent rules and dozens of skills for GitHub, the browser, macOS, messaging and releases, plus a sync script
A skills library for Claude Code, Cursor and Codex: team code review, TDD, stacked PRs and repository readiness scoring
A set of 116 skills, 44 agents and safety hooks for Claude Code, Cursor, Codex, Gemini CLI and nine more editors
README in short
The repository is built on the principle that every instruction must change agent behavior: modern models know the basics and context should go to your code. Documentation and talks on Elixir system design are listed as sources.