.agents/skills · v1.0.0

Elixir agent toolkit

Practical instructions for agents working with Elixir, Phoenix, LiveView, and Ecto. Download the complete toolkit or choose only the skill your project needs.

Choose the right guidance

Each skill has one responsibility. Combine them when a change crosses boundaries—for example, a LiveView form backed by an Ecto schema needs interface, testing, and data guidance together.

Schemas · changesets · queries

Ecto Development

Keeps schemas and data changes explicit

Guides schema documentation, meaningful field types, changeset contracts, migrations, associations, and data-integrity tests.

  • Documents why each schema exists and what every field represents.
  • Covers valid, invalid, boundary, constraint, and association scenarios.
  • Makes changeset assertions direct and readable.
Download skill

Modules · types · OTP

Elixir Development

Makes Elixir modules easier to understand

Establishes clear module boundaries, ExDoc documentation, doctests, typespecs, and safe OTP and concurrency practices.

  • Turns public APIs into executable documentation.
  • Uses types to reveal domain meaning and possible outcomes.
  • Keeps processes supervised and concurrent work deliberate.
Download skill

Sessions · scopes · authorization

Phoenix Authentication

Protects authentication boundaries

Keeps routes, live sessions, current scopes, and authorization checks aligned with Phoenix authentication conventions.

  • Prevents protected pages from drifting into public sessions.
  • Keeps identity derived from the established current scope.
  • Tests anonymous, authenticated, and unauthorized paths.
Download skill

Routes · components · HEEx

Phoenix Development

Keeps Phoenix interfaces consistent

Applies Phoenix 1.8 conventions to routes, function components, semantic HEEx, layouts, forms, assets, and responsive states.

  • Reuses components instead of rebuilding interface primitives.
  • Adds stable DOM contracts for accessibility and tests.
  • Preserves modern Phoenix and Tailwind conventions.
Download skill

Hooks · browser events · Vitest

Phoenix JavaScript Hooks

Connects LiveView and JavaScript safely

Organizes shared hooks through assets/js/hooks.js and defines ownership, lifecycle, cleanup, browser events, and JavaScript tests.

  • Keeps hook registration in one predictable architecture.
  • Prevents duplicated listeners and client-owned DOM conflicts.
  • Covers lifecycle and edge cases with the LiveView hook test API.
Download skill

Gherkin · selectors · outcomes

Phoenix LiveView Testing

Tests behavior through stable DOM contracts

Structures callback scenarios in Given–When–Then form and verifies the responsible element instead of searching raw HTML.

  • Makes failures point to the exact broken interaction.
  • Covers mount, params, events, messages, navigation, and forms.
  • Separates rendered behavior from persistence and domain rules.
Download skill

State · callbacks · navigation

Phoenix LiveView

Keeps LiveViews focused on interface orchestration

Keeps business rules in contexts while LiveView callbacks load data, call domain functions, and render the resulting state.

  • Prevents pages from becoming a second domain layer.
  • Uses URL parameters as the source of truth for search and filters.
  • Promotes semantic, mobile-first templates and deliberate streams.
Download skill

.codex/rules

Rules protect dangerous commands

Skills guide how code should be written. Rules control which shell commands require confirmation. The safety package is optional and asks before destructive Ecto tasks, broad dependency cleanup, and shell-wrapped commands.

Review rules before installing them because command permissions should match your own environment and workflow. 

unzip elixir-safety-rules-v1.0.0.zip -d .
Download safety rules

Install in a project

Extract the archive, inspect the instructions, and copy the folders you want into the root of your repository.

  1. 1

    Choose a package

    Use an individual skill for a focused addition, or the complete toolkit when you want the routing file and every workflow.

  2. 2

    Copy the skill folder

    mkdir -p .agents/skills
cp -R ecto-development .agents/skills/
  3. 3

    Merge the project instructions

    Review the downloaded AGENTS.md instead of overwriting your existing file. Keep only the skill routes and project facts that apply to your application.