Skip to content
Back to skills

Api Diff

ASecurity

Compara dos contratos OpenAPI y calcula el impacto SemVer: endpoint o tipo de respuesta eliminado es major, lo aditivo es minor y la documentación es patch, con detalle por ruta.

  • 2 stars
  • 0 votes
  • 0 copies
  • 0 views
  • Added November 18, 2026
ai-agentsgobashapifrontend

Works with

  • api

Security analysis

A100/100

Scanned November 18, 2026

npx -y skills add alberto2005-coder/skills-ia --skill api-diff --agent claude-code

Installs into .claude/skills of the current project.

Are you the author of Api Diff?

Add the live security badge to your README. It updates with every re-scan.

Security grade badge for Api Diff
[![Security: A — Skills Directory](https://www.skillsdirectory.com/api/skills/alberto2005-coder-api-diff/badge)](https://www.skillsdirectory.com/skills/alberto2005-coder-api-diff)

More formats (shields.io, HTML) on the badges page. Keep it an A: scan every change in CI with Pro.

Download with Pro
SKILL.md
---
name: api-diff
description: Compara dos contratos OpenAPI y calcula el impacto SemVer: endpoint o tipo de respuesta eliminado es major, lo aditivo es minor y la documentación es patch, con detalle por ruta.
license: MIT
metadata:
  package: api-contract-guard
  version: "1.1.0"
---

# API Diff

## Objetivo

Decidir con evidencia si un cambio de contrato rompe consumidores, antes de publicarlo.

## Instrucciones de ejecución

1. Ejecuta el diff entre la versión publicada y la nueva:

```bash
py api-contract-guard/scripts/contract_diff.py --old old.json --new new.json --json
```

2. Usa `--fail-on major` en CI: el pipeline se rompe si el cambio rompe consumidores.
3. Anota en el PR el nivel y las rutas afectadas; el `major` exige versión nueva.

## Clasificación

| Cambio | Nivel |
|---|---|
| Endpoint o método eliminado | `major` |
| Tipo de respuesta modificado | `major` |
| Endpoint o método nuevo | `minor` |
| Solo cambia la descripción | `patch` |

## Límites

- Compara JSON OpenAPI, no YAML, y no resuelve `$ref` externos.
- Solo mira el primer código de respuesta (`200`/`201`): cambios en errores no se clasifican.
- No conoce a los consumidores reales: eso lo aporta `api-code-sync`.

## Gate de salida

- Nivel calculado y cambios listados con ruta y detalle.
- Cero `major` sin versión nueva o sin aprobación escrita del responsable.
- El diff queda guardado en JSON junto al PR.

## Handoff

Entrega a `api-code-sync` las rutas eliminadas o cambiadas para localizar las llamadas del frontend que hay que migrar.

Attribution

Is this your skill, or is something wrong with this listing? Request removal or report an issue. Author removals are honored within 72 hours.

View all in ai-agents →

Comments

Loading comments…

Newsletter

Get the weekly list of safe new skills, and the ones we pulled.