Can it help with API documentation?

Yes, it treats the OpenAPI 3.1 specification as the source of truth, ensuring your code implementation remains contract-driven and properly documented.

How does this skill improve API security?

It integrates OWASP API Security Top 10 guidance, providing specific implementation patterns for BOLA protection, rate limiting, and secure token management.

Does it support modern pagination techniques?

Absolutely. It provides specific patterns for offset, cursor-based, and keyset pagination to ensure your API remains performant at scale.

What API standards does the api-expert skill support?

It focuses on OpenAPI 3.1, RESTful principles (Richardson Maturity Model), GraphQL, gRPC, and standard RFCs like RFC 7807 for error handling.

API Design & Architecture Expert

Name: API Design & Architecture Expert
Author: martinholovsky

bymartinholovsky

•

API Development

Architects secure, scalable, and production-grade APIs using REST, GraphQL, and gRPC best practices.

About

This skill equips Claude with the expertise of an elite API architect to design and implement robust backend interfaces. It enforces industry standards such as OpenAPI 3.1, RFC 7807 error handling, and OWASP API Security Top 10 mitigations. By prioritizing a Test-Driven Development (TDD) workflow and rigorous specification verification, it helps developers build high-performance APIs featuring advanced pagination, secure OAuth2/JWT authentication, and sophisticated rate-limiting strategies while avoiding common implementation pitfalls.

Key Features

Standardized error handling using RFC 7807 Problem Details
Advanced pagination patterns including cursor and keyset
OpenAPI 3.1 specification generation and validation
8 GitHub stars
Standardized RESTful resource modeling and HTTP semantics
Security-first implementation following OWASP API Top 10

Use Cases

Designing a scalable microservices architecture with consistent API patterns
Implementing secure OAuth2.1 or JWT authentication and authorization flows
Refactoring legacy endpoints to meet modern performance and security standards

About

Key Features

Standardized error handling using RFC 7807 Problem Details
Advanced pagination patterns including cursor and keyset
OpenAPI 3.1 specification generation and validation
8 GitHub stars
Standardized RESTful resource modeling and HTTP semantics
Security-first implementation following OWASP API Top 10

Use Cases

Designing a scalable microservices architecture with consistent API patterns
Implementing secure OAuth2.1 or JWT authentication and authorization flows
Refactoring legacy endpoints to meet modern performance and security standards