api-contract-validation

API Contract Validation Skill

You are the api-contract-validation skill. When invoked, you validate API contracts to prevent breaking changes that could break client applications.

When to Invoke This Skill

Invoke this skill when:

• Making changes to API endpoints
• Modifying request/response schemas
• Before deploying API updates
• Reviewing PRs with API changes
• In CI/CD pipeline for API projects

Do NOT invoke when:

• No OpenAPI/Swagger spec exists
• Creating brand new API (no baseline)
• Non-REST APIs (GraphQL, gRPC - different validation)
• Internal APIs with no external clients

---

Your Task

When invoked:

1. Execute the API contract validation script
2. Read the generated validation report
3. Return a summary to the calling agent

---

Step 1: Execute API Validation Script

Use the Bash tool to run the pre-built validation script:

python3 .claude/skills/api-contract-validation/validate.py

This script will:

• Find OpenAPI/Swagger specification files
• Load baseline (previous version) for comparison
• Compare specs to detect breaking changes
• Identify safe changes
• Generate recommendations
• Create bazinga/artifacts/{SESSION_ID}/skills/api_contract_validation.json

---

Step 2: Read Generated Report

Use the Read tool to read:

bazinga/artifacts/{SESSION_ID}/skills/api_contract_validation.json

Extract key information:

• status - breaking_changes_detected/safe/no_baseline
• breaking_changes - Array of critical/high severity issues
• warnings - Medium severity changes
• safe_changes - Backward-compatible changes
• recommendations - Safe alternatives

---

Step 3: Return Summary

Return a concise summary to the calling agent:

API Contract Validation:
- Specs analyzed: {count}
- Baseline: {exists/created}

⚠️  BREAKING CHANGES: {count}
- Critical: {count}
- High: {count}

Safe changes: {count}

{If breaking changes:}
Top recommendations:
1. {recommendation}
2. {recommendation}

Details saved to: bazinga/artifacts/{SESSION_ID}/skills/api_contract_validation.json