API Docs

OpenAPI、Swagger、RESTful APIドキュメンテーションのベストプラクティスを提供する専門スキル。Anchors:• 『RESTful Web APIs』（Leonard Richardson）/ 適用: REST APIドキュメンテーション / 目的: リソース設計とHTTP操作の標準化Trigger:OpenAPI/Swagger定義設計時、APIエンドポイント仕様書作成時、REST APIドキュメント整備時、認証仕様文書化時、エラーレスポンス標準化時、ドキュメントレビュー時に使用

JSON Schema仕様に基づくスキーマ設計を専門とするスキル。API仕様の定義、OpenAPI連携、バリデーションルールの標準化を通じて、相互運用性の高いデータ構造を設計します。Anchors:• Effective TypeScript (Dan Vanderkam) / 適用: 型安全性とスキーマ設計 / 目的: 堅牢なスキーマ構造の実現• JSON Schema仕様 (Draft 2020-12) / 適用: 標準スキーマ定義 / 目的: 言語非依存なデータバリデーションTrigger:JSONスキーマ定義、APIレスポンス検証、データバリデーション設計、OpenAPI統合、スキーマ継承パターン、複雑なデータ構造の妥当性確認時に使用。

API仕様に整合したリクエスト/レスポンス例とエラーレスポンス例を作成するスキル。cURLとSDKサンプルを含め、実行可能で説明的な例示を短時間で整備する。Anchors:• OpenAPI Specification / 適用: 例示とスキーマ整合 / 目的: 仕様一致• RFC 7807 Problem Details / 適用: エラーレスポンス設計 / 目的: 形式統一• API Design Patterns (J.J. Geewax) / 適用: 例示設計 / 目的: 利用者理解の促進Trigger:Use when creating API request/response examples, cURL samples, SDK snippets, and error case documentation aligned with the API specification.request response examples, cURL, SDK examples, error responses, OpenAPI

RESTful APIの設計と互換性管理を行うためのスキル。APIバージョニング、Breaking Changes対応、スキーマ設計を含む。**Anchors**:• RESTful Web APIs（Leonard Richardson）/ 適用: API設計全般 / 目的: リソース指向設計の原則の習得• OpenAPI 3.1 仕様（OpenAPI Initiative）/ 適用: API契約設計 / 目的: 標準的なAPI仕様定義• JSON Schema（IETF）/ 適用: スキーマ設計 / 目的: バリデーションルールの明確化**Triggers**: API設計やAPIスキーマの定義が必要な時、バージョニング戦略を策定する時、Breaking Changes対応が必要な時、後方互換性を確保する時に使用

Document REST APIs with OpenAPI/Swagger specifications, endpoint documentation, authentication, error handling, and SDK guides. Use for API reference docs, Swagger specs, and client library documentation. Triggers: api docs, openapi, swagger, endpoint documentation, rest api, api reference, sdk documentation, api specification, document api, api endpoints.

Guide for discovering and integrating with Rubin Science Platform (RSP) APIs using OpenAPI specifications. Use this skill when working with Gafaelfawr authentication APIs (/auth/*), Times Square notebook APIs (/times-square/api/*), or other RSP services. Covers finding OpenAPI specs, using WebFetch to download specifications, creating TypeScript types from schemas, implementing SWR-based hooks, handling authentication patterns (CSRF tokens, credentials), and creating mock APIs for development.

OpenAPI仕様の専門スキル。API定義、スキーマ設計、ドキュメント生成を提供します。Anchors:• 『OpenAPI Specification』（Linux Foundation） / 適用: API仕様設計 / 目的: REST API標準化• 『RESTful API設計のベストプラクティス』（複数出典） / 適用: エンドポイント設計 / 目的: 一貫性確保Trigger:OpenAPI仕様書作成時、API定義ドキュメント作成時、Swagger仕様設計時に使用

Designs RESTful APIs, GraphQL schemas, and RPC interfaces following best practices for consistency, usability, and scalability. Trigger keywords: api design, rest api, graphql, openapi, swagger, endpoint, schema design.

This skill automates API endpoint testing, including request generation, validation, and comprehensive test coverage for REST and GraphQL APIs. It is used when the user requests API testing, contract testing, or validation against OpenAPI specifications. The skill analyzes API endpoints and generates test suites covering CRUD operations, authentication flows, and security aspects. It also validates response status codes, headers, and body structure. Use this skill when the user mentions "API testing", "REST API tests", "GraphQL API tests", "contract tests", or "OpenAPI validation".

Guide for creating FastAPI endpoints following this project's conventions including routers, dependency injection, error handling, and OpenAPI documentation.

This skill validates API contracts using consumer-driven testing and OpenAPI validation. It leverages Pact for consumer-driven contract testing, ensuring that API providers adhere to the expectations of their consumers. It also validates APIs against OpenAPI specifications to guarantee compliance and identify breaking changes. Use this skill when the user asks to generate contract tests, validate API responses, check backward compatibility, or validate requests/responses using the terms "contract-test", "ct", "Pact", "OpenAPI validation", or "consumer-driven contract testing".

Generates comprehensive API documentation including OpenAPI/Swagger specs, endpoint descriptions, request/response examples, and integration guides. Use when documenting APIs.

This skill validates API contracts using consumer-driven testing and OpenAPI validation. It leverages Pact for consumer-driven contract testing, ensuring that API providers adhere to the expectations of their consumers. It also validates APIs against OpenAPI specifications to guarantee compliance and identify breaking changes. Use this skill when the user asks to generate contract tests, validate API responses, check backward compatibility, or validate requests/responses using the terms "contract-test", "ct", "Pact", "OpenAPI validation", or "consumer-driven contract testing".

This skill automates API endpoint testing, including request generation, validation, and comprehensive test coverage for REST and GraphQL APIs. It is used when the user requests API testing, contract testing, or validation against OpenAPI specifications. The skill analyzes API endpoints and generates test suites covering CRUD operations, authentication flows, and security aspects. It also validates response status codes, headers, and body structure. Use this skill when the user mentions "API testing", "REST API tests", "GraphQL API tests", "contract tests", or "OpenAPI validation".

Build production-ready REST APIs with Spring MVC - controllers, validation, exception handling, OpenAPI

Build production-grade FastAPI backends with SQLModel, Pydantic, and JWT authentication. Use this skill when building REST APIs, integrating with Neon PostgreSQL, implementing Better Auth JWT verification, or creating CRUD endpoints. Includes patterns for audit logging, worker/agent parity, and OpenAPI documentation.

Best practices for documenting APIs and code interfaces, eliminating redundant documentation guidance per agent.

REST API 설계 및 구현 표준을 제공합니다. RESTful 원칙에 따른 URL 구조, 리소스 명명, HTTP 메서드 사용을 구현하고, 커서 기반 페이지네이션, 정렬, 필터링 패턴을 보장하며, 일관된 에러 응답과 상태 코드 전략을 유지합니다. API 버전 관리, 인증/인가, CORS 설정, OpenAPI 문서화를 마스터합니다.다음 경우에 사용: REST API 설계, 엔드포인트 정의, RESTful URL 구조 설계, HTTP 메서드 선택(GET/POST/PUT/DELETE), 페이지네이션 구현, 정렬 및 필터링 파라미터 설계, HTTP 상태 코드 결정, 응답 구조 표준화, 에러 핸들링 전략 수립.

基于 gin-gonic/gin 的企业级 Web 框架增强版，提供开箱即用的 JWT 认证、SSE 实时通信、缓存管理、OpenAPI 文档生成等企业级功能。涵盖选项式路由配置、统一响应格式、中间件管理、安全加固、性能优化等完整开发能力。

Universal data format handler supporting JSON, YAML, TOML, XML, and OpenAPI with validation and transformation