phx:brief
openbooklet.com/s/phxbriefopenbooklet.com/s/phxbrief@1.0.0GET /api/v1/skills/phxbriefInteractive briefing of a plan file. Explains reasoning and solution in progressive sections so developers understand before approving or after completion. Use when team members need to understand a plan without reading the full document.
CONTRIBUTOR TOOL - Track CC changelog, extract new versions since last check, analyze impact on plugin (breaking changes, opportunities, deprecations). Run periodically or before releases. NOT part of the distributed plugin.
Debug Ecto constraint violations - trace triggers, check migrations, find duplicate data. Use when seeing unique_constraint, foreign_key_constraint, or check_constraint errors.
Ecto patterns: schemas, changesets, queries, migrations, transactions (Multi/transact), associations/preloads, upserts, and full-text search. Load for Repo calls, Ecto.Query, schema fields, constraints, cast/put_change, preloading, N+1 fixes, SQL injection prevention, float-for-money. Skip for Ash.Resource/Ash.Domain modules.
Scan Ecto code for N+1 query anti-patterns: Repo calls inside Enum.map/each/for loops, association access without preload, missing nested preloads. Use when user reports excessive queries in logs, wants an N+1 audit, or asks to find missing preloads. NOT for general Ecto guidance â use ecto-patterns.
OTP/BEAM patterns and core Elixir idioms â GenServer, Supervisor, Task, Registry, pattern matching, with chains, pipes, error tuples, mix tasks. Load for process design, supervision trees, language idiom refactoring, or BEAM debugging. NOT for Ecto/LiveView/Oban/Phoenix â use dedicated skills.
Fetches HexDocs documentation efficiently using WebFetch tool with automatic HTML-to-markdown conversion for context efficiency. Use this INSTEAD of direct WebFetch when looking up any Elixir library documentation on hexdocs.pm. Handles module docs, function docs, guides, and changelogs for any Hex package. Dramatically reduces token usage compared to raw HTML fetching.
Internal router for ambiguous work requests. Load when user says "add/build/implement feature", "fix/debug/investigate bug", "review/audit code", "refactor/clean up", "slow/performance", "PR comments", "research/evaluate library", or "that fixed it" â WITHOUT an explicit /phx: slash command.
Investigate bugs using the Ralph Wiggum approach: check the obvious, read errors literally.
Self-improving loop for plugin skills. Reads program.md, proposes one mutation per iteration, evaluates against deterministic scorer, keeps improvements via git, reverts failures. Targets weakest skill+dimension. Use with /loop for overnight runs.
LiveView lifecycle & real-time UI. For *_live.ex, mount, handle_event, handle_params, handle_info, assign_async, streams, PubSub, phx-change/phx-submit, uploads, JS hooks, LiveComponent, push_patch, on_mount, socket assigns. NOT for controllers, REST APIs, Ecto, or plain Phoenix.Component.
Diagnostic audit of LiveView socket assigns â inventories every assign with memory footprint estimates, detects missing temporary_assigns, finds unused assigns, and flags unbounded lists needing streams. Use when investigating LiveView memory bloat, auditing assign efficiency, or explicitly requested via /lv:assigns. NOT for general LiveView patterns or building features.
Narrow bare `rescue _ ->` / `rescue e ->` so UndefinedFunctionError, KeyError, and typos propagate instead of being swallowed. Use for auditing rescues, secure-coding review, exception review, refactoring error handling in Elixir.
Oban job processing â workers, perform/1, queues, cron scheduling, retries, unique jobs, idempotency. Oban Pro workflows/batches/process/1. Oban.Worker, Oban.Testing, assert_enqueued, perform_job, queue config, backoff. Prevents atom-key args, struct serialization, non-idempotent jobs.
Phoenix context module design: creating/splitting contexts, adding context functions, cross-context boundaries, Scope struct (1.8+), Ecto.Multi in contexts, PubSub broadcasting. Also: router pipelines, scope blocks, verified routes, plugs, controller delegation to contexts, JSON API controllers.
Project health audit across 5 areas (architecture, performance, security, tests, dependencies) using parallel specialist agents. Use quarterly, before major releases, after large refactors, or when onboarding. Also use when the user mentions "project health", "code quality overview", "how healthy is this codebase", or any request for holistic assessment.
Validate Phoenix context boundaries and dependencies using mix xref. Use when reviewing PRs, before major refactors, when contexts feel tangled, or when a module has too many cross-context dependencies. Also use when planning context splits or evaluating architecture health.
Brainstorm Elixir/Phoenix features â explore ideas, compare approaches, gather requirements. Use when vague idea, not sure how to approach, or want to discuss before plan.
Challenge mode reviews - rigorous questioning before approving changes. Use when you want thorough scrutiny of Ecto changes, LiveView events, or PR readiness.
Use after fixing any non-trivial bug, resolving a tricky issue, or when the user says "that worked" or "it is fixed". Also suggest proactively after successful /phx:review or /phx:investigate. Captures solved problems as searchable Elixir/Phoenix solution documentation for faster future debugging.
Practical examples and walkthroughs for Elixir/Phoenix patterns, including plugin workflow demonstrations. Use whenever the user asks "how do I...", "show me an example of...", "what does X look like", or needs to see a working implementation pattern for Phoenix, LiveView, Ecto, or OTP features. Also triggers when the user asks about plugin commands or wants to see what a workflow produces.
Auto-indexed from oliver-kriska/claude-elixir-phoenix
Are you the author? Claim this skill to take ownership and manage it.
Related Skills
graceful-error-recovery
Use this skill when a tool call, command, or API request fails. Diagnose the root cause systematically before retrying or changing approach. Do not retry the same failing call without first understanding why it failed.
audience-aware-communication
Use this skill when writing any explanation, documentation, or response that will be read by someone else. Match vocabulary, depth, and format to the audience's expertise level before writing.
Refactoring Expert
Expert in systematic code refactoring, code smell detection, and structural optimization. Use PROACTIVELY when encountering duplicated code, long methods, complex conditionals, or any code quality issues. Detects code smells and applies proven refactoring techniques without changing external behavior.
Research Expert
Specialized research expert for parallel information gathering. Use for focused research tasks with clear objectives and structured output requirements.
clarify-ambiguous-requests
Use this skill when the user's request is ambiguous, under-specified, or could be interpreted in multiple ways. If proceeding with a wrong assumption would waste significant work, always ask exactly one focused clarifying question before doing anything.
structured-step-by-step-reasoning
Use this skill for any problem that involves multiple steps, tradeoffs, or non-trivial logic. Think out loud before answering to improve accuracy and transparency. Apply whenever the answer is not immediately obvious.