How does this facilitate AI collaboration?

It generates specific 'Director' and 'Implementor' roles and handoff documents that define clear boundaries for how different AI instances should design versus execute code.

What is the 'Dave Thomas style' mentioned in this skill?

It refers to structuring Elixir projects as a collection of specialized applications linked via path-based dependencies instead of using traditional umbrella apps, which improves modularity and testing.

Can I use this for financial or e-commerce systems?

Yes, it includes specific guardrails for data integrity, optimistic locking, and money-handling best practices (such as avoiding floats for currency).

Does this skill require the Ash Framework?

While highly recommended for its declarative power, the architect skill can be adapted, though its primary patterns are built around Ash resources and actions.

Elixir System Architect

Name: Elixir System Architect
Author: maxim-ist

bymaxim-ist

•

API Development

Architects production-ready Elixir and Phoenix systems using Ash Framework and OTP best practices for AI-driven development.

The Elixir Architect skill transforms Claude into a senior system designer capable of building robust, scalable Elixir/OTP applications. It follows industry-leading patterns from experts like Dave Thomas and Saša Jurić, focusing on the Ash Framework for declarative domain modeling and path-based dependencies for modular project structure. By generating comprehensive Architecture Decision Records (ADRs), supervision tree plans, and rigorous guardrail documentation, this skill ensures that both human developers and AI agents (Director/Implementor roles) can collaborate effectively on complex, fault-tolerant systems.

Key Features

0171 GitHub stars

02Dave Thomas-style multi-app project structuring with path-based dependencies

03Comprehensive architecture documentation including ADRs and system overviews

04Declarative domain modeling and API generation using the Ash Framework

05Standardized guardrails and handoff protocols for Director/Implementor AI collaboration

06Fault-tolerant OTP supervision tree planning and Oban worker configuration

Use Cases

01Designing a high-concurrency SaaS platform backend from scratch

02Restructuring a monolithic Elixir app into a modular, multi-app system

03Establishing rigorous AI-to-AI handoff workflows for complex software implementation

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add maxim-ist/elixir-architect elixir-architect

For use in Claude.ai and ChatGPT

Download Skill