Generate OpenAPI 3.0 JSON specs from ColdBox handler annotations.
npx skills add https://github.com/ColdBox/skills --skill cbswagger
Please help me install this Agent Skill. Skill: cbswagger Source: https://github.com/ColdBox/skills/tree/main/modules/cbswagger Command: npx skills add https://github.com/ColdBox/skills --skill cbswagger
Generating accurate, up-to-date OpenAPI documentation for ColdBox/BoxLang REST APIs can be manual, inconsistent, and easily drift from the codebase; this skill automates extraction of endpoint metadata from handler annotations and schema files so documentation stays synchronized with implementation.
Scan the project's ColdBox handlers and generate a complete OpenAPI 3.0 JSON specification using cbswagger configuration and handler annotations.
High-intent search queries and answers about installing and using this skill.
cbswagger scans ColdBox REST handlers and action-level JSDoc annotations to automatically produce a compliant OpenAPI 3.0 JSON specification, ensuring API documentation stays synchronized with the codebase.
Annotation-driven spec generation extracts endpoint metadata directly from ColdBox handler annotations and JSON schema files, preventing manual documentation drift and keeping Swagger docs synchronized with the REST API implementation.
Yes, you can host Swagger UI and ReDoc routes directly within your ColdBox application. The generation process exposes these endpoints natively, allowing you to publish a protected developer discovery UI alongside your REST API.
Yes, cbswagger supports loading shared external JSON schema files for request and response shapes. This schema management capability allows you to avoid duplication when documenting complex API payloads across multiple endpoints.
You define JWT or Bearer security schemes in OpenAPI for a ColdBox API by configuring security definitions within the generator, which extracts these schemes from module configurations to document protected endpoints in the JSON spec.
Yes, you can run OpenAPI spec generation in CI pipelines for ColdBox APIs. The generator supports configurable output paths, allowing backend teams to commit a canonical OpenAPI 3.0 JSON spec automatically during continuous integration.
rxtech-labGenerate OpenAPI specs from Zod schemas and sync them to a Swift iOS client.
teexiiiServe interactive Swagger UI and raw OpenAPI spec from a TypeScript-based definition.
mrigsbyAutomate ColdBox route definitions and RESTful API endpoints via scripts.
zhaono1Generate OpenAPI 3.0/3.x specifications and endpoint documentation from REST APIs.
