nacos-api-doc-update

To sync Nacos API markdown docs with Swagger OpenAPI specs, this Skill automates refreshing the api.json and updates markdown documentation in place, comparing changes per endpoint to reflect the latest API definitions.

You can update API parameters, URLs, and curl examples without overwriting manual markdown notes, because this Skill applies targeted in-place updates to existing docs and preserves manual edits during the synchronization process.

The best way to automate refreshing api.json for Nacos console and admin APIs is using this Skill to auto-refresh and validate the Swagger/OpenAPI definitions, then apply targeted markdown updates to reduce documentation drift.

Updating Nacos OpenAPI documentation generates a diff report for review, enforcing safety rules by attempting curl refreshes first and avoiding bulk replacements to ensure you can verify all parameter and endpoint changes before finalizing.

To prevent unintended changes when syncing deprecated Nacos API endpoints, this Skill supports exemptions and per-endpoint rules, allowing you to avoid overwriting docs when specific APIs are deprecated or ignored.

Nacos API documentation drifts from underlying Swagger specs when manual markdown updates lag behind code changes, a problem this Skill solves by automating the synchronization of api.json definitions directly into the repository docs.