Skills Agentes

Openapi Spec Generation

Genera y mantiene especificaciones OpenAPI 3.1 a partir de código, con enfoque design-first y patrones de validación de contratos de API.

Estrellas
39.8k

en todo el repo

Actividad
43

0–100, la ruta de este skill

Actualizado
hace 4 meses

último commit aquí

Commits
0

últimos 90 días

Contexto
511 tok

49 tok en reposo

Paquete
3 archivos

25 KB

Instalar

Funciona con cualquier agente que lea SKILL.md

npx -y skills add wshobson/agents --skill openapi-spec-generation --agent claude-code

Se instala solo en este repositorio.

Este skill makes network requests.

Qué hace

  • Genera y mantiene especificaciones OpenAPI 3.1 a partir de código existente
  • Aplica un enfoque design-first para escribir contratos de API antes de codificar
  • Valida implementaciones de API contra su especificación
  • Aporta plantillas y ejemplos detallados en references/details.md

Úsalo cuando

  • Crear documentación de API desde cero
  • Generar specs OpenAPI a partir de código existente
  • Diseñar contratos de API con enfoque design-first
  • Generar SDKs de cliente a partir de specs o montar portales de documentación

No lo uses cuando

    Qué lo activa

    Di cualquiera de estas frases y el agente debería cargar este skill.

    • “Genera la especificación OpenAPI 3.1 para esta API REST”
    • “Crea el contrato de API antes de implementar el código”
    • “Valida que mi implementación cumple con el spec OpenAPI”

    SKILL.md

    En inglés

    OpenAPI Spec Generation

    Comprehensive patterns for creating, maintaining, and validating OpenAPI 3.1 specifications for RESTful APIs.

    When to Use This Skill

    • Creating API documentation from scratch
    • Generating OpenAPI specs from existing code
    • Designing API contracts (design-first approach)
    • Validating API implementations against specs
    • Generating client SDKs from specs
    • Setting up API documentation portals

    Core Concepts

    1. OpenAPI 3.1 Structure

    openapi: 3.1.0
    info:
      title: API Title
      version: 1.0.0
    servers:
      - url: https://api.example.com/v1
    paths:
      /resources:
        get: ...
    components:
      schemas: ...
      securitySchemes: ...
    

    2. Design Approaches

    Approach Description Best For
    Design-First Write spec before code New APIs, contracts
    Code-First Generate spec from code Existing APIs
    Hybrid Annotate code, generate spec Evolving APIs

    Templates and detailed worked examples

    Full template library and detailed worked examples live in references/details.md. Read that file when you need the concrete templates.

    Best Practices

    Do's

    • Use $ref - Reuse schemas, parameters, responses
    • Add examples - Real-world values help consumers
    • Document errors - All possible error codes
    • Version your API - In URL or header
    • Use semantic versioning - For spec changes

    Don'ts

    • Don't use generic descriptions - Be specific
    • Don't skip security - Define all schemes
    • Don't forget nullable - Be explicit about null
    • Don't mix styles - Consistent naming throughout
    • Don't hardcode URLs - Use server variables

    Reproducido de wshobson/agents bajo licencia MIT. Leer esta página en markdown.

    Archivos

    3 archivos en el paquete. Solo se lee SKILL.md al activarse — las referencias se cargan si el skill decide que las necesita.

    Detalles

    Creador
    wshobson
    Licencia
    MIT
    Recursos incluidos
    referencias
    Repositorio
    wshobson/agents
    Código fuente
    Ver SKILL.md

    Etiquetas

    Más de wshobson/agents

    Este repo incluye 183 skills. Si instalas uno, normalmente ya tienes los demás. Ver el pack agents entero y su comando de instalación

    Instala y opera Hermes Tweet, un plugin de Hermes Agent para investigar X/Twitter, leer timelines, analizar tweets y ejecutar operaciones privadas o de cambio de estado con aprobación previa.

    Costo de contexto al activarse
    1.4k tok
    Tamaño del paquete
    3 archivos
    Última actualización
    el mes pasado
    redes sociales

    Úsalo para mantener un almacén Markdown de conocimiento donde cada afirmación compilada se rastrea hasta una fuente inmutable y el drift se detecta con git diff sin gastar tokens.

    Costo de contexto al activarse
    1.4k tok
    Tamaño del paquete
    2 archivos
    Última actualización
    hace 24 días
    documentos

    Úsalo al diseñar o revisar un esquema específico de PostgreSQL: buenas prácticas, tipos de datos, indexación, restricciones, patrones de rendimiento y funciones avanzadas.

    Costo de contexto al activarse
    2k tok
    Tamaño del paquete
    2 archivos
    Última actualización
    hace 24 días
    bases de datos

    Úsalo cuando un proyecto guarda su estado en Superself: lee `self context` al iniciar sesión, vincula el trabajo a una work unit, reporta con evidencia y registra decisiones confirmadas.

    Costo de contexto al activarse
    1.3k tok
    Tamaño del paquete
    1 archivo
    Última actualización
    hace 24 días
    productividad

    Úsalo cuando pidan optimizar un prompt, mejorar su rendimiento, diseñar una plantilla, aplicar chain-of-thought, few-shot prompting o técnicas avanzadas de prompt engineering para producción.

    Costo de contexto al activarse
    1.3k tok
    Tamaño del paquete
    10 archivos
    Última actualización
    el mes pasado
    herramientas desarrollo

    Audita y reescribe prosa para que deje de sonar generada por máquina. Incluye modo solo-detección, modo reescritura y modo edición en el lugar, con perfiles opcionales de voz y contexto.”

    Costo de contexto al activarse
    1.9k tok
    Tamaño del paquete
    4 archivos
    Última actualización
    el mes pasado
    redaccion contenido

    Skills relacionados

    Implementa interfaces conformes con WCAG 2.2, con accesibilidad móvil, patrones de diseño inclusivo y soporte para tecnologías de asistencia.

    Costo de contexto al activarse
    601 tok
    Tamaño del paquete
    5 archivos
    Última actualización
    hace 4 meses
    desarrollo apis

    Domina los principios de diseño REST y GraphQL para construir APIs intuitivas, escalables y mantenibles que encanten a los desarrolladores.

    Costo de contexto al activarse
    901 tok
    Tamaño del paquete
    6 archivos
    Última actualización
    hace 4 meses
    desarrollo apis

    Implementa protocolos DeFi con plantillas listas para producción de staking, AMMs, gobernanza y flash loans. Úsalo al construir aplicaciones de finanzas descentralizadas o contratos inteligentes.

    Costo de contexto al activarse
    1.9k tok
    Tamaño del paquete
    2 archivos
    Última actualización
    hace 3 meses
    desarrollo apis