Documentación de API automatizada a partir del código fuente

Olvídate de actualizar Swagger manualmente. Esta skill realiza un análisis estático profundo de tu código fuente backend para generar documentación de API de nivel profesional al instante. Mapea rutas, métodos, esquemas y requisitos de autenticación sin necesidad de introducción manual ni claves de API.

Qué hace

• Detección multifranework: Compatible con Node.js (Express, Next.js, Hono, Koa), Python (FastAPI, Flask, Django REST) y más.
• Extracción profunda de esquemas: Infiere las estructuras de solicitud/respuesta a partir de interfaces TypeScript, esquemas Zod, modelos Pydantic y comentarios JSDoc.
• Mapeo de autenticación: Identifica automáticamente las rutas protegidas detectando middleware como JWT, Passport o dependencias de FastAPI.
• Doble formato de salida: Exporta a YAML OpenAPI 3.0 válido para herramientas externas o Markdown limpio para READMEs y wikis internas.

¿Por qué usar esta skill?

Escribir documentación es tedioso y propenso a desincronizarse con el código real. A diferencia de los prompts genéricos, esta skill utiliza heurísticas específicas para analizar tu sistema de archivos, comprender los patrones de enrutamiento propios de cada framework e inferir tipos a partir de convenciones de nomenclatura de variables cuando los tipos explícitos no están disponibles. Genera documentación estructurada y lista para producción que sigue los estándares del sector.

Herramientas del sector compatibles

• Especificaciones: OpenAPI 3.0.3 (Swagger)
• Documentación: Markdown con formato GitHub
• Validación: Compatible con Swagger UI, Redoc y Postman