famaoai-creator

api-evolution-manager

Governs the evolution of public APIs. Detects breaking changes, manages deprecation cycles, and generates migration guides for clients.

famaoai-creator 1 2 Updated 6mo ago

Resources

2
GitHub

Install

npx skillscat add famaoai-creator/gemini-skills/api-evolution-manager

Install via the SkillsCat registry.

About this skill

The API Evolution Manager detects breaking changes by comparing OpenAPI or GraphQL schemas to manage API lifecycles and deprecation cycles. It solves the problem of backward compatibility issues by automatically generating migration guides for downstream consumers. Developers should use this skill to audit version updates and ensure seamless transitions between API versions.

SKILL.md

API Evolution Manager

This skill ensures that your API grows gracefully without breaking downstream consumers.

Capabilities

1. Breaking Change Detection

  • Compares current API schemas (OpenAPI, GraphQL) with previous versions.
  • Flags any changes that would break backward compatibility.

2. Lifecycle Management

  • Manages deprecation notices and sunsetting schedules.
  • Automatically generates "Migration Guides" for developers using the API.

Usage

  • "Audit the latest API changes for breaking changes and update the versioning plan."
  • "Generate a migration guide for clients moving from v1.0 to v2.0."

Knowledge Protocol

  • This skill adheres to the knowledge/orchestration/knowledge-protocol.md. It automatically integrates Public, Confidential (Company/Client), and Personal knowledge tiers, prioritizing the most specific secrets while ensuring no leaks to public outputs.