What problem does it solve?
APIs drift when versioning, deprecation timelines, and documentation lacking consistency. This skill provides a structured approach to design, govern, and evolve APIs with predictable lifecycles across REST and GraphQL.
Core Features & Use Cases
- Versioning strategies: URL path versioning, header versioning, and transition plans.
- Deprecation processes: 5-step deprecation workflow including announcement, marking, monitoring, sunset, and removal.
- Rate limiting guidelines: recommended strategies and typical quotas per tier.
- Documentation standards: OpenAPI 3.1 documentation and changelog requirements.
- Use Cases: Plan lifecycle for new services and maintain existing APIs through evolution.
Quick Start
Apply this skill to plan an API lifecycle for a new REST service, outlining versioning, deprecation, rate limiting, and OpenAPI documentation requirements.