VerifiedPlugin
claude-code-ghost
A Claude Code plugin marketplace for managing Ghost blogs.
1 skill
@georgeguimaraesBackend
Plugin
claude-code-elixir
Claude Code plugins for Elixir development.
Plugin Signal53/100Fair
maintained52
capable41
documented75
adopted47
Install on Claude Code
> /plugin marketplace add georgeguimaraes/claude-code-elixir
What's inside
Skill(6 skills)
/ecto-thinkingThis skill should be used when the user asks to "add a database table", "create a new context", "query the database", "add a field to a schema", "validate form input", "fix N+1 queries", "preload this association", "separate these concerns", or mentions Repo, changesets,/elixir-thinkingThis skill should be used when the user asks to "implement a feature in Elixir", "refactor this module", "should I use a GenServer here?", "how should I structure this?", "use the pipe operator", "add error handling", "make this concurrent", or mentions protocols, behaviours,/oban-thinkingThis skill should be used when the user asks to "add a background job", "process async", "schedule a task", "retry failed jobs", "add email sending", "run this later", "add a cron job", "unique jobs", "batch process", or mentions Oban, Oban Pro, workflows, job queues, cascades,/otp-thinkingThis skill should be used when the user asks to "add background processing", "cache this data", "run this async", "handle concurrent requests", "manage state across requests", "process jobs from a queue", "this GenServer is slow", or mentions GenServer, Supervisor, Agent, Task,/phoenix-thinkingThis skill should be used when the user asks to "add a LiveView page", "create a form", "handle real-time updates", "broadcast changes to users", "add a new route", "create an API endpoint", "fix this LiveView bug", "why is mount called twice?", or mentions handle_event,/using-elixir-skillsThis skill should be used when the user works on any .ex or .exs file, mentions Elixir/Phoenix/Ecto/OTP, the project has a mix.exs, or asks "which skill should I use", "new to Elixir", "help with Elixir". Routes to the correct thinking skill BEFORE exploring code. Triggers on
README
Claude Code Elixir
Claude Code plugins for Elixir development.
Installation
claude plugin marketplace add georgeguimaraes/claude-code-elixir
Install all plugins:
claude plugin install elixir-lsp@claude-code-elixir && \
claude plugin install mix-format@claude-code-elixir && \
claude plugin install mix-compile@claude-code-elixir && \
claude plugin install mix-credo@claude-code-elixir && \
claude plugin install elixir@claude-code-elixir
Prerequisites
Install the expert binary and make sure it's on your PATH. See installation instructions.
Note:
mix-format,mix-compile, andmix-credorequire bash (Git Bash or WSL on Windows).
Plugins
Overview
| Plugin | Type | Description |
|---|---|---|
| elixir-lsp | LSP | Language Server with completions, go-to-definition, diagnostics |
| mix-format | Hook | Auto-format .ex/.exs files on save |
| mix-compile | Hook | Compile with --warnings-as-errors on save |
| mix-credo | Hook | Run Credo code quality checks on save |
| elixir | Skills | BEAM architecture, Phoenix, Ecto, OTP patterns |
Tools
elixir-lsp
Elixir Language Server integration powered by Expert.
| Feature | Description |
|---|---|
| Navigation | Go to definition, find references |
| Completions | With signature help and docs |
| Diagnostics | Compiler warnings and errors |
| File types | .ex, .exs, .heex, .leex |
mix-format
Auto-runs mix format after editing .ex and .exs files.
mix-compile
Auto-runs mix compile --warnings-as-errors after editing .ex files.
- Only
.exfiles (not.exsscripts/tests) - Finds
mix.exsby walking up directories - Fails on warnings or errors
mix-credo
Auto-runs mix credo after editing .ex and .exs files to check code quality.
- Runs on both
.exand.exsfiles - Uses project's default Credo configuration
- Gracefully skips if Credo is not installed
- Fails on code quality issues
Skills
elixir
Paradigm-shifting skills for Elixir, Phoenix, and OTP development. Includes a SessionStart hook that auto-suggests skills when working on Elixir code.
Included skills:
| Skill | Use When |
|---|---|
elixir-thinking | Designing modules, processes, data structures |
phoenix-thinking | Working with Phoenix, LiveView, PubSub |
ecto-thinking | Working with Ecto, contexts, schemas |
otp-thinking | Implementing GenServers, supervisors, Tasks |
elixir-thinking
Mental models for writing Elixir — how it differs from OOP.
| Concept | Insight |
|---|---|
| Iron Law | NO PROCESS WITHOUT A RUNTIME REASON |
| Three dimensions | Behavior, state, mutability are decoupled |
| Processes | For runtime (state/concurrency/faults), not code organization |
| "Let it crash" | Means "let it heal" — supervisors restart |
| Polymorphism | Behaviors → Protocols → Message passing (least to most dynamic) |
- José Valim - Gang of None
- Saša Jurić - The Soul of Erlang and Elixir
- Saša Jurić - Clarity
- Designing Elixir Systems with OTP
- Official Elixir Guides
phoenix-thinking
Architectural patterns for Phoenix and LiveView.
| Concept | Insight |
|---|---|
| Where to load data | mount/3 by default; handle_params/3 for live navigation (push_patch) |
| Initial double-load | mount and handle_params both run twice; use connected?/1, assign_async/3, or assign_new/3 |
| Scopes (1.8+) | Security-first authorization threading |
| PubSub | Scoped topics, broadcast_from to avoid self-broadcast |
| Channel fastlane | Socket state can be stale — re-fetch or include in broadcast |
ecto-thinking
Architectural patterns for Ecto and contexts.
| Concept | Insight |
|---|---|
| Contexts | Bounded domains with their own "dialect" |
| Cross-context refs | Use IDs, not belongs_to associations |
| Schemas | Multiple changesets per schema, embedded_schema for forms |
| Preloads | Separate vs join — pick based on data shape |
| pool_count vs pool_size | pool_count = DBConnection pools, pool_size = connections per pool |
- Phoenix Contexts Guide
- German Velasco - DDD for Phoenix Contexts (ElixirConf 2024)
- Ecto Multi-Tenancy Guide
otp-thinking
OTP design patterns and when to use each abstraction.
| Concept | Insight |
|---|---|
| Iron Law | GENSERVER IS A BOTTLENECK BY DESIGN |
| ETS | Bypasses bottleneck — concurrent reads with :read_concurrency |
| Task.Supervisor | THE pattern for async work (not raw Task.async) |
| Registry + DynamicSupervisor | Named dynamic processes without atom leaks |
| Broadway vs Oban | External queues vs background jobs — different problems |
- Erlang OTP Design Principles
- Elixir GenServer Docs
- Elixir School - OTP Concurrency
- Saša Jurić - Elixir in Action
- Stephen Bussey - Real-Time Phoenix
Known Issues
elixir-lsp: client/registerCapability workaround. Claude Code's LSP client doesn't respond to client/registerCapability requests that Expert sends during initialization (anthropics/claude-code#32595). The plugin includes a Python wrapper (expert-wrapper) that intercepts these requests and auto-responds so Expert can initialize properly. The wrapper will be removed once the upstream fix lands. Requires Python 3 on PATH.
Troubleshooting
expert not found: Ensure the expert binary is on your PATH. See installation instructions.
License
Copyright (c) 2025 George Guimarães
Licensed under the Apache License, Version 2.0. See LICENSE for details.
File tree
georgeguimaraes/claude-code-elixirView on GitHub
.claude-plugin/
marketplace.json
.gitignore
LICENSE
plugins/
elixir/
elixir-lsp/
.claude-plugin/
plugin.json
bin/
expert-wrapper
.claude-plugin/
plugin.json
hooks/
hooks.json
run-hook.cmd
session-start.sh
skills/
ecto-thinking/
SKILL.md
elixir-thinking/
SKILL.md
oban-thinking/
SKILL.md
otp-thinking/
SKILL.md
phoenix-thinking/
SKILL.md
using-elixir-skills/
SKILL.md
mix-compile/
.claude-plugin/
plugin.json
hooks/
compile-elixir.sh
hooks.json
mix-credo/
.claude-plugin/
plugin.json
hooks/
credo-elixir.sh
hooks.json
mix-format/
.claude-plugin/
plugin.json
hooks/
format-elixir.sh
hooks.json
README.md
scripts/
fetch_github_wisdom.exs
test/
verify-plugins.shMore Flows by @georgeguimaraes.
@georgeguimaraesFAQ
claude-code-elixir is a Claude Code plugin with 6 hand-picked skills for backend work, indexed on Flowy. Install it with the command on its page. It includes ecto-thinking, elixir-thinking, oban-thinking. Its skills do not fire on their own yet. Request auto-invocation to have Flowy route them as you prompt. Free and open source.
- What is claude-code-elixir?
- Claude Code plugins for Elixir development.
- How do I install claude-code-elixir?
- Run these in Claude Code: /plugin marketplace add georgeguimaraes/claude-code-elixir. Then prompt normally.
- Does claude-code-elixir auto-invoke its skills?
- Not yet. It is indexed on Flowy as a plain plugin. Request auto-invocation on its page and Flowy will route its skills for you as you prompt.
- Is claude-code-elixir free?
- Yes. Flowy is free and open source, with nothing gated. You can read every skill in full before you install.