What common mistakes does this skill help avoid?

It specifically warns against anti-patterns like exposing raw database IDs, creating deeply nested types without pagination, and circular dependencies.

Does it provide guidance on project structure?

Absolutely. It recommends organizing types by domain and importing them into a central schema, which is the standard approach for large-scale Absinthe projects.

Can I use this for complex data types like polymorphic results?

Yes, it includes specific patterns for implementing GraphQL Unions and Interfaces, which are essential for handling diverse data types in a single field.

How does this skill help with Elixir GraphQL development?

It provides structured templates and best practices for defining Absinthe schemas, ensuring your API follows Elixir standards and remains maintainable.

Absinthe GraphQL Schema Design

Name: Absinthe GraphQL Schema Design
Author: TheBushidoCollective

byTheBushidoCollective

•

API Development

Architects robust and scalable GraphQL schemas in Elixir using the Absinthe framework and industry-best practices.

This Claude Code skill provides a comprehensive framework for designing high-quality GraphQL APIs within the Elixir ecosystem. It guides developers through complex schema definitions—including interfaces, unions, and custom scalars—while enforcing professional organization patterns that separate types from queries and mutations. By implementing domain-driven design principles, this skill helps you avoid common pitfalls like circular dependencies and over-nested types, ensuring your API remains maintainable as your application grows.

Key Features

01Custom scalar integration for UUIDs, DateTimes, and JSON types

02Standardized implementation of GraphQL Interfaces and Unions

0339 GitHub stars

04Domain-driven organization patterns for modular schema design

05Anti-pattern detection for pagination and circular dependencies

06Best practices for Non-Null fields and Input Object definitions

Use Cases

01Building a scalable GraphQL API for a Phoenix web application

02Implementing polymorphic data structures with search and result unions

03Refactoring monolithic schema files into domain-specific modules

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add thebushidocollective/han absinthe-schema

For use in Claude.ai and ChatGPT

Download Skill