aip-knowledge

Provide Google API Improvement Proposals reference knowledge for REST/OpenAPI design.

Updated Dec 10, 2025
One-click install
npx skills add https://github.com/getlarge/claude-aip-plugins --skill aip-knowledge
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: aip-knowledge
Source: https://github.com/getlarge/claude-aip-plugins/tree/main/plugins/aip-api-design/skills/aip-knowledge
Command: npx skills add https://github.com/getlarge/claude-aip-plugins --skill aip-knowledge

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill provides a compact reference of Google API Improvement Proposals (AIP) adapted for REST/OpenAPI, helping reviewers, API designers, and developers apply consistent rules and avoid common mistakes.

Core Features & Use Cases

  • Comprehensive reference of AIP topics and patterns (errors, pagination, filtering, LRO, field masks, and batch operations) for REST/OpenAPI design and review.
  • Context-driven loading of relevant AIP topics when reviewing or designing APIs, enabling quick guidance without leaving your workflow.
  • Quick lookups of implemented rules and mappings to standard REST/OpenAPI practices.

Quick Start

Ask the AI to load the AIP knowledge for a specific topic, then request concise explanations or examples, e.g., "Explain AIP-158 pagination for a list endpoint."

Frequently Asked Questions about aip-knowledge

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I apply Google API Improvement Proposals to REST and OpenAPI design?

AIP provides standardized patterns for REST APIs covering errors, pagination, filtering, long-running operations, field masks, and batch operations. Load the AIP knowledge for your specific topic—such as pagination or error handling—to get reference rules and REST/OpenAPI mappings that guide endpoint design and ensure consistency across your API.

What does AIP-158 pagination look like in a REST API?

AIP-158 defines pagination patterns adapted for REST/OpenAPI. The knowledge base includes the specific rules and field mappings for implementing list endpoints with page tokens or offset-limit pagination, enabling you to design consistent, queryable endpoints.

Can I use AIP patterns to catch API design mistakes during review?

Yes. The Skill includes linter rules mapped to AIP standards for REST/OpenAPI, allowing you to review endpoints against established patterns for errors, filtering, batch operations, and other common design areas without manual verification.

How do field masks and long-running operations work in REST APIs according to AIP?

AIP defines field mask and LRO patterns adapted for REST/OpenAPI. The reference knowledge covers the exact field structures, HTTP semantics, and polling patterns you need to implement these advanced operations consistently.

What's the difference between AIP error handling and standard HTTP error responses?

AIP error handling extends standard HTTP status codes with structured error details and machine-readable codes. The knowledge base maps AIP error patterns to REST/OpenAPI, showing how to design error responses that include context and recovery guidance beyond basic status codes.