Back to Skills

using-elixir-skills

verified

This 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 "implement", "add", "fix", "refactor" in Elixir projects.

View on GitHub

Marketplace

claude-code-elixir

georgeguimaraes/claude-code-elixir

Plugin

elixir

skills

Repository

georgeguimaraes/claude-code-elixir
80stars

plugins/elixir/skills/using-elixir-skills/SKILL.md

Last Verified

January 23, 2026

Install Skill

Select agents to install to:

Scope:
npx add-skill https://github.com/georgeguimaraes/claude-code-elixir/blob/main/plugins/elixir/skills/using-elixir-skills/SKILL.md -a claude-code --skill using-elixir-skills

Installation paths:

Claude
.claude/skills/using-elixir-skills/
Powered by add-skill CLI

Instructions

<EXTREMELY-IMPORTANT>
If the task involves Elixir, Phoenix, or OTP code, you MUST invoke the relevant skill BEFORE doing ANYTHING else—including exploring the codebase.

THIS IS NOT OPTIONAL. Skills tell you HOW to explore and WHAT to look for. You cannot rationalize your way out of this.
</EXTREMELY-IMPORTANT>

## The Rule

```
Elixir/Phoenix/OTP task → Invoke skill FIRST → Then explore/research → Then write code
```

**Skills come before exploration.** The skills tell you what patterns to look for, what questions to ask, and what anti-patterns to avoid. Exploring without the skill means you don't know what you're looking for.

## Skill Triggers

| Trigger Phrases | Skill to Invoke |
|-----------------|-----------------|
| code, implement, write, design, architecture, structure, pattern | `elixir-thinking` |
| LiveView, Plug, PubSub, mount, channel, socket, component | `phoenix-thinking` |
| context, schema, Ecto, changeset, preload, Repo, migration | `ecto-thinking` |
| GenServer, supervisor, Task, ETS, bottleneck, Broadway | `otp-thinking` |
| Oban, workflow, job queue, cascade, graft, background job, async job | `oban-thinking` |

## Red Flags

These thoughts mean STOP—invoke the skill:

| Thought | Reality |
|---------|---------|
| "Let me explore the codebase first" | Skills tell you WHAT to look for. Invoke first. |
| "Let me understand the code first" | Skills guide understanding. Invoke first. |
| "But first, let me..." | No. Skills come first. Always. |
| "I'll add a process to organize this" | Processes are for runtime, not organization. |
| "GenServer is the Elixir way" | GenServer is a bottleneck by design. |
| "I'll query in mount" | mount is called twice. |
| "Task.async is simpler" | Use Task.Supervisor in production. |
| "I know Elixir well enough" | These skills contain paradigm shifts. Invoke them. |

Validation Details

Front Matter
Required Fields
Valid Name Format
Valid Description
Has Sections
Allowed Tools
Instruction Length:
1841 chars