maxnorm avatar

Magento Api Developer

This one handles the specific patterns Magento 2 uses for API development, including service contracts, DTOs, and the repository pattern that Adobe Commerce enforces. You'd reach for it when building REST or GraphQL endpoints for headless storefronts, mobile apps, or third-party integrations. It covers the full workflow from planning service contracts through implementing authentication and GraphQL resolvers. The nice thing here is it gets into the Magento-specific architecture decisions like maintaining backward compatibility in versioned interfaces and optimizing GraphQL query complexity, which matters when you're working within Adobe's fairly opinionated framework rather than rolling your own API from scratch.

skills.sh installs
245
GitHub stars
32
last updated
Aug 21, 2026

Install

$ npx -y skills add maxnorm/magento2-agent-skills --skill magento-api-developer --agent claude-code

Installs into .claude/skills of the current project.

Files

Magento 2 API Developer

Expert specialist in designing and implementing robust, scalable REST and GraphQL APIs that serve as reliable data interfaces for headless commerce, mobile applications, and third-party integrations.

When to Use

  • Developing REST or GraphQL APIs
  • Creating service contracts
  • Building headless commerce solutions
  • Integrating with external systems
  • Implementing API authentication and authorization
  • Designing data transfer objects

API Architecture

Service Contracts

  • Design clean, versioned API interfaces
  • Create data transfer objects (DTOs) for data exchange
  • Implement repository pattern for data access
  • Maintain backward compatibility

REST API Design

  • Implement RESTful endpoints following industry best practices
  • Use proper HTTP methods (GET, POST, PUT, DELETE)
  • Design consistent URL structures
  • Implement proper status codes

GraphQL Implementation

  • Build efficient GraphQL schemas and resolvers
  • Optimize query complexity
  • Implement proper caching strategies
  • Handle nested relationships efficiently

API Development Process

Sponsors

Details

Repository
github.com/maxnorm/magento2-agent-skills
Categories
Backend & APIs, Security, Code Review & Quality, AI & Agent Building
First seen
Jun 3, 2026

More from maxnorm/magento2-agent-skills

All 9
1connorads avatarpayload-cmsconnorads/dotfilesUse when working with Payload CMS projects (payload.config.ts, collections, fields, hooks, access control, Payload API). Triggers on tasks involving: collection240skills.sh installs
2davila7 avatarclerk-authdavila7/claude-code-templatesExpert patterns for Clerk auth implementation, middleware, organizations, webhooks, and user sync Use when: adding authentication, clerk auth, user authenticati220skills.sh installs
3martinholovsky avatargraphql-expertmartinholovsky/claude-skills-generatorExpert GraphQL developer specializing in type-safe API development, schema design, resolver optimization, and federation architecture. Use when building GraphQL218skills.sh installs
4yonatangross avatarapi-designyonatangross/orchestkitAPI contract design for REST and GraphQL, covering resource shape, URL and header versioning with deprecation windows, RFC 9457 Problem Details error handling, 211skills.sh installs
5davepoon avatarauth-patternsdavepoon/buildwithclaudeThis skill should be used when the user asks about "authentication in Next.js", "NextAuth", "Auth.js", "middleware auth", "protected routes", "session managemen182skills.sh installs
6borghei avatardatabase-designerborghei/claude-skillsDatabase design with schema analysis, index optimization, and migration generation for PostgreSQL, MySQL, MongoDB, and DynamoDB. Use when designing schemas, opt170skills.sh installs