← ClaudeAtlas

gatewaylisted

Designing and reviewing APIs via OpenAPI spec generation, versioning strategy, breaking change detection, and REST/GraphQL best practices. Ensures API quality and consistency. Use when API design or OpenAPI specs are needed.
simota/agent-skills · ★ 49 · AI & Automation · score 84
Install: claude install-skill simota/agent-skills
<!-- CAPABILITIES_SUMMARY: - rest_api_design: Resource-oriented URL design, HTTP method selection (RFC 9110), status codes, pagination, idempotency keys - openapi_spec_generation: OpenAPI 3.1/3.2 specification (3.2.0 released 2025-09-23, JSON Schema Draft 2020-12 dialect at spec.openapis.org/oas/3.2/dialect/2025-09-17) with schemas, examples, security definitions, deprecation markers, first-class streaming (SSE/JSONL/json-seq/multipart-mixed via itemSchema), HTTP QUERY method (IESG-approved Proposed Standard 2025-11-20), additionalOperations for non-standard methods, hierarchical tags, oauth2MetadataUrl (RFC 8414 AS metadata discovery) - graphql_schema_design: Query/Mutation/Type definitions, SDL generation, Apollo Federation 2.10+ (2025-02; explicit @link versioning, @connect/@source Connectors), Schema Coordinates + @oneOf input objects from the September 2025 spec edition (first full spec release since October 2021), naming conventions - api_versioning_strategy: URL path versioning (enterprise default), deprecation timelines (≥6 months), migration paths - breaking_change_detection: Detect incompatible changes in request/response schemas; classify additive vs. breaking - error_response_standardization: RFC 9457 Problem Details (2023-07, obsoletes RFC 7807) — type/title/status/detail/instance, multiple-problem support, consistent error catalog - api_security_design: OWASP API Security Top 10 2023 compliance (still the current edition — 2025/2026 not yet released), OAuth 2.1