What are Google AIPs?

API Improvement Proposals (AIP) are a set of design guidelines used to ensure consistency and usability across APIs, originally developed by Google.

Can it help with complex operations like Batch or LRO?

Absolutely. It contains specialized reference knowledge for implementing Batch operations and Long-Running Operations (async jobs) according to standard patterns.

What kind of linter rules are included?

It includes 17 automated rules covering resource naming (pluralization, no verbs), standard HTTP methods, pagination parameters, and error schema definitions.

Does this skill work with OpenAPI and Swagger?

Yes, this skill is specifically adapted to apply AIP principles to RESTful APIs defined in OpenAPI or Swagger formats.

Google AIP API Design Assistant

Name: Google AIP API Design Assistant
Author: getlarge

bygetlarge

0•

API開発

Enforces Google API Improvement Proposals (AIP) standards for REST and OpenAPI design to ensure consistent and scalable interfaces.

The AIP Knowledge skill acts as a domain-specific expert for Google's API Improvement Proposals, specifically adapted for REST and OpenAPI environments. It provides developers with a robust framework for designing, reviewing, and documenting APIs by implementing 17 automated linter rules across categories like naming, pagination, and idempotency. Whether you are implementing complex patterns like Long-Running Operations (LRO), field masks for partial updates, or standardized error handling, this skill provides the necessary reference material and validation to ensure your API meets industry-leading architectural standards.

主な機能

01Mapping guidance for translating Protobuf (Proto) concepts to RESTful patterns

020 GitHub stars

03Standardized pagination patterns using page_size and page_token

04Comprehensive guides for Long-Running Operations (LRO) and batch processing

05Automated linting for resource naming, HTTP methods, and status codes

06Schema validation for AIP-193 compliant error responses

ユースケース

01Conducting automated architectural reviews of OpenAPI specifications

02Implementing idempotent POST requests and partial updates via field masks

03Designing robust list endpoints with advanced filtering and sorting logic

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add getlarge/claude-aip-plugins aip-knowledge

For use in Claude.ai and ChatGPT

主な機能

01Mapping guidance for translating Protobuf (Proto) concepts to RESTful patterns

020 GitHub stars

03Standardized pagination patterns using page_size and page_token

04Comprehensive guides for Long-Running Operations (LRO) and batch processing

05Automated linting for resource naming, HTTP methods, and status codes

06Schema validation for AIP-193 compliant error responses

ユースケース

01Conducting automated architectural reviews of OpenAPI specifications

02Implementing idempotent POST requests and partial updates via field masks

03Designing robust list endpoints with advanced filtering and sorting logic

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add getlarge/claude-aip-plugins aip-knowledge

For use in Claude.ai and ChatGPT