Scaffold Zalando-compliant OpenAPI 3.1 and AsyncAPI 3.0 specifications from enterprise templates.
npx skills add https://github.com/epieczko/betty --skill api-define
Please help me install this Agent Skill. Skill: api.define Source: https://github.com/epieczko/betty/tree/main/skills/api.define Command: npx skills add https://github.com/epieczko/betty --skill api-define
Manually creating API specifications is time-consuming and prone to inconsistencies, especially when adhering to enterprise guidelines. This Skill automates the generation of production-ready OpenAPI and AsyncAPI specs, embedding best practices like RFC 7807 error handling, correct naming conventions, and required metadata.
user-service API. Instead of manually writing the OpenAPI spec, they use api.define to generate a Zalando-compliant spec in seconds, ensuring it meets all enterprise standards from the start.python skills/api.define/api_define.py user-service openapi --template=zalando
High-intent search queries and answers about installing and using this skill.
OpenAPI specification generation automates creation of production-ready API contracts. api.define scaffolds Zalando-compliant OpenAPI 3.1 specs from enterprise templates, embedding RFC 7807 error handling, snake_case naming, JWT security, and X-Flow-ID headers in seconds, eliminating manual inconsistencies.
Yes. api.define generates AsyncAPI 3.0 specifications alongside OpenAPI contracts. It handles template-driven scaffolding for asynchronous services, applying the same enterprise best practices and naming conventions to event-driven architectures.
Template-driven scaffolding accelerates spec creation by applying predefined enterprise patterns. api.define loads YAML/JSON templates, substitutes variables, extracts resource names, applies versioning, and writes output to a configurable directory—turning spec authoring from hours to minutes.
No prerequisite expertise required. api.define automates the technical details: template selection, variable substitution, and spec generation handle RFC 7807 compliance, security schemes, and metadata. You supply the service name and API type; the Skill produces compliant specs.
Enterprise templates embed Zalando guidelines into the generation process. api.define enforces snake_case naming, JWT authentication schemes, RFC 7807 Problem JSON error responses, X-Flow-ID headers, and metadata requirements automatically—ensuring consistency across all scaffolded APIs.
api.define writes published API IDs and titles alongside YAML/JSON outputs to your configured directory. Downstream steps integrate with API registries, validation tools, or documentation platforms to version, publish, and monitor the generated specifications.
SiyeolryuCreate Claude skill scaffolds with SKILL.md frontmatter and template resources.
Jet-labsGenerate OpenAPI 3.1+ and AsyncAPI specs with interactive documentation.
icartshDesign RESTful and GraphQL APIs with OpenAPI 3.0 specifications.
viktorbezdekDesign REST, GraphQL and gRPC APIs with authentication and pagination templates.