SkillsAdd

davidcastagnetoa/skills

openapi_asyncapi_contracts

Definir y versionar contratos de interfaz entre agentes REST (OpenAPI) y asíncronos (AsyncAPI)

First seen Mar 6, 2026

Installation

$ npx skills add davidcastagnetoa/skills --skill openapi_asyncapi_contracts
View on skills.sh ↗ GitHub repository ↗

Similar popular skills

Related neighbors and high-traction skills in the same topics — useful to compare before installing.

find-skills Same topic
vercel-labs/skills

Helps users discover and install agent skills when they ask questions like "how do I do X", "fi…

3.3M installs
agent-browser Same topic
vercel-labs/agent-browser

Browser automation CLI for AI agents. Use when the user needs to interact with websites, includ…

810.4K installs
vercel-react-best-practices Same topic
vercel-labs/agent-skills 697.8K installs
web-design-guidelines Same topic
vercel-labs/agent-skills

Review UI code for Web Interface Guidelines compliance. Use when asked to "review my UI", "chec…

617.3K installs
microsoft-foundry Same topic
microsoft/azure-skills

Build, deploy, evaluate, optimize, fine-tune, and manage Microsoft Foundry agents, models, and …

576.5K installs
azure-prepare Same topic
microsoft/azure-skills

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Te…

568.3K installs

Also in this package

Other skills from davidcastagnetoa/skills · top by installs.

npx skills add davidcastagnetoa/skills
traefik 116 prisma-nestjs-patterns 58 easyocr 50 exif_metadata_analyzer 30 c4_model_structurizr 28 configurable_thresholds 25 alembic 23 insightface_arcface 19 asyncpg 19 github_actions_cicd 16

Browse all from davidcastagnetoa/skills

More details

Agent compatibility

Declared targets from SKILL.md / docs. Unmarked agents are not listed — the skill may still install via the CLI.

Claude Code Not declared
Cursor Not declared
Codex Not declared
GitHub Copilot Not declared
Windsurf Not declared
Gemini CLI Not declared
Cline Not declared
OpenCode Not declared

Repository health

Stars 1
Default branch main
Open issues 0
Status Active

Package contents

Files included with this skill beyond the listing page.

  • skill md SKILL.md 1,394 B
  • docs SUMMARY.md 129 B

History

  1. First seen on skills.sh
  2. First recorded snapshot · 5 installs

SKILL.md

openapiasyncapicontracts

Los contratos entre agentes definen los schemas de datos que cada agente acepta y produce. Son la fuente única de verdad para comunicación inter-agente y previenen breaking changes.

When to use

Usar para documentar y versionar todos los contratos entre agentes: endpoints REST, payloads de Celery y eventos de auditoría.

Instructions

  1. FastAPI genera OpenAPI automáticamente en /openapi.json; verificar que está completo y correcto.
  2. Versionar el openapi.json en Git: comparar con la versión anterior en cada PR.
  3. Para mensajes asíncronos de Celery, definir contratos en AsyncAPI 2.x:

- Crear asyncapi.yaml en docs/contracts/. - Documentar cada canal (cola Celery) con su schema de mensaje.

  1. Implementar un breaking change detector en CI:

- pip install openapi-spec-validator oasdiff. - oasdiff breaking oldspec.yaml newspec.yaml → falla el CI si hay breaking changes.

  1. Usar Pydantic models como fuente única de verdad y generar los specs desde el código.

Notes