Skip to content
Back to skills

Api Contract Guard

ASecurity

Orquesta la defensa de un contrato de API: diff SemVer entre versiones, cruce de rutas backend/frontend y servidor mock local, con veredicto major/minor/patch y evidencia reproducible.

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

Works with

  • cli
  • api

Security analysis

A100/100

Pro scans all 14 files and shows the line behind each finding

Scanned November 18, 2026

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

Installs into .claude/skills of the current project.

Are you the author of Api Contract Guard?

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

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

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-contract-guard
description: Orquesta la defensa de un contrato de API: diff SemVer entre versiones, cruce de rutas backend/frontend y servidor mock local, con veredicto major/minor/patch y evidencia reproducible.
license: MIT
metadata:
  package: api-contract-guard
  version: "1.1.0"
---

# API Contract Guard

## Propósito

Evitar que un cambio de API rompa a quien la consume: decidir si el impacto es `major`, `minor` o `patch`, encontrar las llamadas del frontend que ya no existen y levantar un mock local para probar sin backend.

## Flujo

1. **Diff** con `api-diff`: compara la versión publicada con la nueva y calcula el impacto SemVer.
2. **Cruce** con `api-code-sync`: verifica que cada llamada del frontend tenga su endpoint y cada endpoint su consumidor.
3. **Cobertura** con `api-auth-coverage`: las rutas que el contrato marca protegidas deben llevar guarda en el código.
4. **Mock** con `api-mock-server`: sirve los ejemplos del contrato en `127.0.0.1` para probar el cliente sin desplegar nada.
5. **Veredicto**: un `major` exige versión nueva de la API y plan de migración; un `minor` solo requiere anuncio.

## Sub-skills

| Sub-skill | Qué hace |
|---|---|
| `api-diff` | Diff OpenAPI → `major`/`minor`/`patch` con detalle por ruta |
| `api-code-sync` | Rutas backend vs llamadas frontend: `dead-call` y `sin-consumidor` |
| `api-auth-coverage` | `security` del contrato frente a las guardas del código |
| `api-mock-server` | Servidor HTTP local con los ejemplos del contrato |

## Reglas

- Sin red: el diff y el cruce son estáticos y el mock solo escucha en loopback.
- Un `major` no se negocia con un umbral: se publica una versión nueva.
- Todo hallazgo lleva ruta, método y evidencia; lo que no se pudo analizar se declara.
- Una ruta que el contrato marca protegida y el código no guarda no se publica.

## Gate de salida

- Diff calculado con su nivel y la lista de cambios por ruta.
- Cruce cerrado: cero `dead-call` o cada una justificada.
- Si se levantó el mock, el contrato y el puerto usados quedan escritos.

## Handoff

Entrega a `api-diff` la versión anterior y a `api-code-sync` las rutas afectadas. Si el frontend no está en el alcance, dilo y limita el veredicto al contrato.

Files in this skill

  • SKILL.md2.2 KB
  • api-auth-coverage/SKILL.md2.6 KB
  • api-code-sync/SKILL.md1.8 KB
  • api-diff/SKILL.md1.5 KB
  • api-mock-server/SKILL.md1.7 KB
  • scripts/auth_coverage.py7.5 KB
  • scripts/code_sync.py4.3 KB
  • scripts/contract_diff.py4.1 KB
  • scripts/mock_server.py3.4 KB
  • skills.json1 KB
  • tests/test_auth_coverage.py4.5 KB
  • tests/test_code_sync.py2.5 KB
  • tests/test_contract_diff.py2.9 KB
  • tests/test_mock_server.py1.6 KB

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.