aip

fredrikaverpil's avatarfrom fredrikaverpil

Google API Improvement Proposals (AIP) reference. Use BEFORE designing or reviewing APIs, protobuf definitions, or any work involving Google API design standards. Fetches relevant AIP rules from https://google.aip.dev for the task at hand.

⭐190stars🔀6forks📁View on GitHub🕐Updated Jan 3, 2026
[API Helpers]

When & Why to Use This Skill

The Google API Improvement Proposals (AIP) skill is a specialized tool designed to help developers and architects adhere to Google's official API design standards. By fetching real-time documentation from google.aip.dev, it ensures that API endpoints, protobuf definitions, and resource-oriented services are built with consistency, scalability, and industry best practices, preventing errors caused by outdated or inaccurate memory of complex rules.

Use Cases

  • 1. API Design & Protobuf Definition: Reference specific AIPs to ensure new service definitions and messages follow Google's standardized patterns and naming conventions.
  • 2. Code Review & Compliance: Use the skill during pull request reviews to verify that proposed API changes adhere to official design guidelines and architectural standards.
  • 3. Resource-Oriented Service Implementation: Guide the development of RESTful-style APIs by following AIP rules for resource naming, standard methods, and field masks.
  • 4. Field and Method Naming: Resolve naming ambiguities by referencing specific AIP guidelines to maintain clarity and professional standards across large-scale distributed systems.
nameaip
descriptionGoogle API Improvement Proposals (AIP) reference. Use BEFORE designing or reviewing APIs, protobuf definitions, or any work involving Google API design standards. Fetches relevant AIP rules from https://google.aip.dev for the task at hand.

Google API Improvement Proposals (AIP)

When working on API design, protobuf definitions, or any task involving Google API standards, refresh your understanding of the relevant AIP rules.

Critical Rule

NEVER assume you know what an AIP rule says from memory. Always fetch and read the actual AIP documentation before applying or referencing any rule. Your memory of AIP rules may be inaccurate or outdated.

Process

  1. Browse the AIP index - Go to https://google.aip.dev/general to see all available AIP guidelines
  2. Identify relevant AIPs - Based on the task at hand, determine which AIP rules may apply
  3. Fetch and read the relevant AIPs - Use WebFetch to retrieve the specific AIP pages. Do NOT skip this step, even if you think you know what the rule says
  4. Apply the standards - Ensure your work follows the AIP guidelines as documented

When to Invoke This Skill

  • Designing new API endpoints or protobuf messages
  • Reviewing API changes in PRs
  • Implementing resource-oriented services
  • Naming fields, methods, or resources
  • Working with google.api annotations