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.

About

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

Custom scalar integration for UUIDs, DateTimes, and JSON types
Standardized implementation of GraphQL Interfaces and Unions
39 GitHub stars
Domain-driven organization patterns for modular schema design
Anti-pattern detection for pagination and circular dependencies
Best practices for Non-Null fields and Input Object definitions

Use Cases

Building a scalable GraphQL API for a Phoenix web application
Implementing polymorphic data structures with search and result unions
Refactoring monolithic schema files into domain-specific modules

About

Key Features

Custom scalar integration for UUIDs, DateTimes, and JSON types
Standardized implementation of GraphQL Interfaces and Unions
39 GitHub stars
Domain-driven organization patterns for modular schema design
Anti-pattern detection for pagination and circular dependencies
Best practices for Non-Null fields and Input Object definitions

Use Cases

Building a scalable GraphQL API for a Phoenix web application
Implementing polymorphic data structures with search and result unions
Refactoring monolithic schema files into domain-specific modules