← Back to Skills Marketplace
Swagger2 To Openapi3
by
wangteng85859
· GitHub ↗
· v1.0.0
· MIT-0
124
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install swagger2-to-openapi3
Description
Use when migrating Java Spring Boot projects from Swagger 2 (Springfox) to OpenAPI 3.0 (SpringDoc), including annotation replacements, import updates, and ja...
Usage Guidance
This skill appears to do what it says: run the included Python scripts to migrate Swagger 2 annotations/imports to OpenAPI 3. Before running: 1) Ensure your project is committed to version control or backed up (the scripts overwrite files). 2) Always run with --dry-run first and review the diffs. 3) Be aware the tools use regular expressions (not an AST parser) and may produce false positives/negatives or alter comments/strings in edge cases — manually inspect complex cases (responses, ApiImplicitParam, custom annotations). 4) Confirm you have Python 3 available and run tests/compile after migration. If you need stronger guarantees, consider using a parser-based migration or adding automatic backups.
Capability Analysis
Type: OpenClaw Skill
Name: swagger2-to-openapi3
Version: 1.0.0
The skill bundle is a legitimate utility designed to automate the migration of Java Spring Boot projects from Swagger 2 (Springfox) to OpenAPI 3.0 (SpringDoc). It consists of a shell wrapper (migrate.sh) and Python scripts (migrate_annotations.py, migrate_imports.py, migrate_swagger_to_openapi.py) that perform regex-based text replacements on .java files to update annotations and import statements (including javax to jakarta migration). The code logic is transparent, lacks any network activity or data exfiltration, and includes safety features like a dry-run mode and directory exclusion (e.g., .git, target).
Capability Assessment
Purpose & Capability
The name/description, SKILL.md, README, examples, shell wrapper, and three Python scripts all implement Java migration (annotation and import replacements and javax→jakarta changes). Required resources (none) and files included are appropriate for that purpose.
Instruction Scope
Runtime instructions explicitly tell the agent/user to run the included Python scripts against a provided project path. The scripts walk the given project tree, read .java files, and (unless --dry-run) overwrite them. They do not read environment variables, contact remote endpoints, or access files outside the provided project path, but they will modify arbitrary files under the supplied directory — use backups or VCS.
Install Mechanism
No install spec; this is instruction-only with included local scripts. Scripts run with the host Python interpreter; nothing is downloaded or installed from external URLs.
Credentials
The skill declares no environment variables or credentials. The scripts only require filesystem access to the project path provided at runtime, which is proportional to the declared functionality.
Persistence & Privilege
always is false and the skill does not request persistent or system-wide configuration. It does not modify other skills or agent settings. Note: default autonomous invocation is allowed by platform but not a problem here given the lack of excessive privileges.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install swagger2-to-openapi3 - After installation, invoke the skill by name or use
/swagger2-to-openapi3 - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial release — comprehensive migration guide for upgrading from Swagger 2 (Springfox) to OpenAPI 3.0 (SpringDoc) in Java Spring Boot projects.
- Provides annotation replacement tables and code examples for all major API documentation annotations.
- Details package import changes (swagger.annotations → swagger.v3.oas.annotations, javax.* → jakarta.*).
- Includes automated migration script instructions for batch processing of annotations and packages.
- Covers common migration issues and solutions, including Swagger UI path changes and jakarta migration tips.
- Offers practical step-by-step and manual review guidance for complex migration scenarios.
Metadata
Frequently Asked Questions
What is Swagger2 To Openapi3?
Use when migrating Java Spring Boot projects from Swagger 2 (Springfox) to OpenAPI 3.0 (SpringDoc), including annotation replacements, import updates, and ja... It is an AI Agent Skill for Claude Code / OpenClaw, with 124 downloads so far.
How do I install Swagger2 To Openapi3?
Run "/install swagger2-to-openapi3" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Swagger2 To Openapi3 free?
Yes, Swagger2 To Openapi3 is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Swagger2 To Openapi3 support?
Swagger2 To Openapi3 is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Swagger2 To Openapi3?
It is built and maintained by wangteng85859 (@wangteng85859); the current version is v1.0.0.
More Skills