Can it generate technical documentation automatically?

Yes, it generates standardized OpenAPI specifications in YAML format based on the resources and operations defined in your API context.

Does this skill support protocol-specific best practices?

Yes, it includes specialized patterns for REST resource naming, gRPC proto3 streaming types, and GraphQL complexity analysis.

Does it provide guidance on error handling and retries?

It includes a comprehensive mapping of HTTP status codes and pre-configured client retry strategies with exponential backoff and jitter.

How does it handle API security during the design phase?

It enforces security validation rules, requiring authentication methods like OAuth2 or JWT for third-party consumers and recommending mTLS for internal traffic.

API Architecture & Design

Name: API Architecture & Design
Author: pluginagentmarketplace

bypluginagentmarketplace

•

API開発

Architects production-grade API systems using REST, gRPC, and GraphQL patterns with integrated security and validation rules.

概要

The API Architecture skill is a comprehensive framework designed to help developers build robust, scalable, and secure communication interfaces. It provides domain-specific guidance for designing API contracts across multiple protocols, enforcing strict naming conventions, and implementing advanced security patterns like OAuth2 and mTLS. Whether you are building internal microservices using gRPC or public-facing RESTful endpoints, this skill automates the creation of OpenAPI specifications and ensures your architecture follows industry best practices for error handling, rate limiting, and observability.

主な機能

Built-in security validation for public and private APIs
Pre-configured client retry logic and idempotency patterns
1 GitHub stars
Multi-protocol design support for REST, gRPC, and GraphQL
Automated OpenAPI specification generation in YAML format
Standardized error handling and HTTP status code mapping

ユースケース

Designing scalable RESTful microservices with hierarchical resource structures
Creating secure third-party APIs with integrated rate limiting and complexity analysis
Implementing high-performance gRPC service definitions for internal system communication

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add pluginagentmarketplace/custom-plugin-system-design api-architecture

For use in Claude.ai and ChatGPT

Download Skill

GitHub

概要