Skip to main content
Back to registry

openapi-spec-generation

wshobson/agents

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

Installs3
Install command
npx skills add https://github.com/wshobson/agents --skill openapi-spec-generation
Security audits
Gen Agent Trust HubPASS
SocketPASS
SnykPASS
About this skill
Comprehensive patterns for creating, maintaining, and validating OpenAPI 3.1 specifications for RESTful APIs. - 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 - 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'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

Source description provided by the upstream skill listing. Community reviews and install context appear in the sections below.

Community Reviews

Latest reviews

Sign in to review

No community reviews yet. Be the first to review.

Browse this skill in context
FAQ
What does openapi-spec-generation do?

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

Is openapi-spec-generation good?

openapi-spec-generation does not have approved reviews yet, so SkillJury cannot publish a community verdict.

What agent does openapi-spec-generation work with?

openapi-spec-generation currently lists compatibility with Agent compatibility has not been published yet..

What are alternatives to openapi-spec-generation?

Skills in the same category include telegram-bot-builder, flutter-app-size, sharp-edges, iterative-retrieval.

How do I install openapi-spec-generation?

npx skills add https://github.com/wshobson/agents --skill openapi-spec-generation

Related skills

More from wshobson/agents

Related skills

Alternatives in Software Engineering