onboard-to-openapi-server
CommunityAutomate the migration of Express routers to OpenAPI tooling.
Authorjacobduijzer
Version1.0.0
Installs0
System Documentation
What problem does it solve?
This Skill simplifies the migration of existing Backstage backend plugin's hand-written Express router to the typed OpenAPI tooling, enhancing maintainability and scalability.
Core Features & Use Cases
- Router Migration: Converts Express routers to typed OpenAPI definitions.
- Server Stub Generation: Generates server stubs for typed routing.
- Client Generation: Optionally generates typed clients for API consumption.
- Test Migrations: Optionally migrates router tests to OpenAPI test wrappers.
- Use Case: Migrate a plugin with a complex router to leverage OpenAPI for better documentation and easier maintenance.
Quick Start
Run the onboard-to-openapi-server skill on your plugin directory to start the migration process.
Dependency Matrix
Required Modules
backstage-repo-tools
Components
scripts
💻 Claude Code Installation
Recommended: Let Claude install automatically. Simply copy and paste the text below to Claude Code.
Please help me install this Skill: Name: onboard-to-openapi-server Download link: https://github.com/jacobduijzer/bimcollab-backstage-demo/archive/main.zip#onboard-to-openapi-server Please download this .zip file, extract it, and install it in the .claude/skills/ directory.
Agent Skills Search Helper
Install a tiny helper to your Agent, search and equip skill from 620,000+ vetted skills library on demand.