api-compat
Installation
SKILL.md
API Compatibility Check
Detect breaking changes in API definitions. Read-only analysis, safe to re-run.
1. Prerequisites
Check for specialized tools via command -v: buf (protobuf), oasdiff (OpenAPI). Report availability. If missing, fall back to manual git-diff analysis and note which tool would improve accuracy.
2. Scope
If $ARGUMENTS names specific files, analyze only those. Otherwise, find API files changed since base branch using git diff --name-only $(git merge-base HEAD main). Detect by pattern:
| Pattern | Type |
|---|---|
*.proto |
Protobuf |
openapi.yaml, swagger.json, *.openapi.*, *.swagger.* |
OpenAPI |
*.graphql, *.gql |
GraphQL |
*.go with exported types changed |
Go exported API |