Does this skill follow specific industry standards?

Yes, it defaults to Zalando-compliant templates which include RFC 7807 error handling, specific metadata (x-api-id), and snake_case naming conventions.

What API specifications are supported by api.define?

api.define supports both OpenAPI 3.1 for RESTful services and AsyncAPI 3.0 for event-driven architectures.

Can I specify a custom output directory for my API files?

Yes, you can use the --output-dir parameter to define a custom path for your generated YAML specifications.

Will the generated specs pass standard validation tests?

The specs are designed to be compatible with tools like api.validate, ensuring they pass strict linting and enterprise compliance checks with zero errors.

How does the skill handle resource paths and naming?

It automatically extracts resource names from your service name. For example, 'user-service' automatically generates '/users' paths with pluralized logic.

Enterprise API Scaffolder

Name: Enterprise API Scaffolder
Author: epieczko

byepieczko

0•

API開発

Generates enterprise-compliant OpenAPI and AsyncAPI specifications using standardized templates and best practices.

api.define is a powerful tool for API-first development that scaffolds production-ready contracts according to strict organizational standards. It automates the creation of OpenAPI 3.1 and AsyncAPI 3.0 specifications, ensuring that every API includes essential features like RFC 7807 error handling, consistent snake_case naming conventions, and required metadata. By handling the boilerplate of API design—including resource extraction, pluralization, and security scheme configuration—it allows developers to maintain high quality and consistency across microservices while ensuring all generated specs are ready for immediate validation.

主な機能

010 GitHub stars

02Pre-configures security schemes like JWT and mandatory tracing headers

03Generates Zalando-compliant OpenAPI 3.1 and AsyncAPI 3.0 specifications

04Implements RFC 7807 Problem JSON for standardized error reporting

05Automatically enforces snake_case and kebab-case naming conventions

06Smart resource extraction and pluralization from service names

ユースケース

01Bootstrapping a new microservice with a validated REST API contract

02Defining event-driven architectures with Kafka-ready AsyncAPI definitions

03Enforcing consistent API design standards across an entire engineering organization

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add epieczko/betty api.define

For use in Claude.ai and ChatGPT

Download Skill