Does this skill require Docker?

Yes, the Bitda infrastructure, including PostgreSQL and Keycloak containers, must be running for the API server to start and provide the documentation.

What is the Swagger Snapshot skill?

It is a specialized Claude Code skill that launches a temporary Bitda API server to capture and save the current Swagger (/v3/api-docs) JSON for development purposes.

How does it handle port conflicts?

The skill automatically scans the operating system for two available ports to use for the app and management interfaces, preventing conflicts with other running services.

What happens if the API server fails to start?

The skill will monitor the boot process for up to 120 seconds. If it fails, it provides a boot.log for debugging and ensures all temporary processes are cleaned up.

Where can I find the collected snapshots?

Snapshots are stored in timestamped folders within /tmp/bitda-swagger-snapshot/, containing the JSON spec, metadata, and startup logs.

Swagger Snapshot

Name: Swagger Snapshot
Author: invigoworks

byinvigoworks

0•

API 开发

Captures the latest API specifications by running a temporary server instance and saving Swagger JSON snapshots to local storage.

The Swagger Snapshot skill automates the extraction of API documentation from the Bitda backend by spinning up a lightweight, temporary Spring Boot instance on dynamically assigned ports. It eliminates manual setup by automatically performing health checks, retrieving the /v3/api-docs JSON, and storing the results in a timestamped directory with comprehensive metadata and logs. This ensures developers have immediate access to the most current API state for documentation synchronization, client generation, or version comparison without worrying about port conflicts or server management.

主要功能

01Automated Actuator health check monitoring for server readiness

02Graceful shutdown and cleanup of background processes

030 GitHub stars

04Real-time Swagger JSON extraction and timestamped storage

05Automatic port allocation for temporary server instances

06Detailed logging and metadata generation for troubleshooting

使用场景

01Capturing point-in-time snapshots of API specifications for version comparison

02Synchronizing API documentation with the latest backend code changes

03Providing input data for downstream API client or interface generation skills

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add invigoworks/invigo-marketplace swagger-snapshot

For use in Claude.ai and ChatGPT

Download Skill