← Back to Skills Marketplace
xueyetianya

Swagger Generator

by bytesagain4 · GitHub ↗ · v2.0.1 · MIT-0
cross-platform ✓ Security Clean
370
Downloads
0
Stars
1
Active Installs
10
Versions
Install in OpenClaw
/install swagger-generator
Description
Generate OpenAPI 3.0 specs from endpoint descriptions. Use when validating APIs, generating docs, formatting YAML, checking schemas, linting contracts.
Usage Guidance
This skill is coherent with its stated purpose and does not try to access external credentials or network resources. However, the included script logs every command input to $HOME/.local/share/swagger-generator (per-command .log files and history.log) and can export those logs. Before using: (1) avoid entering real secrets/API keys or sensitive request bodies into the tool; (2) inspect the script if you want to change the DATA_DIR location or file permissions; (3) if you do use it with sensitive data, delete the data directory afterward (rm -rf ~/.local/share/swagger-generator) or modify the script to store logs in a secure location; (4) if you need a stricter privacy posture, run the SKILL.md instructions without executing the shipped script or ask the author for a version that does not persist inputs.
Capability Analysis
Type: OpenClaw Skill Name: swagger-generator Version: 2.0.1 The skill bundle appears to be a placeholder or a mock implementation. While SKILL.md describes a comprehensive OpenAPI specification generator, the actual implementation in scripts/script.sh only performs basic logging of input arguments to a local directory (~/.local/share/swagger-generator). There is no evidence of data exfiltration, remote execution, or malicious intent; the script lacks any network capabilities and only interacts with its own log files.
Capability Assessment
Purpose & Capability
Name/description (OpenAPI/Swagger generation) match the provided CLI-like instructions (spec, endpoint, model, crud, auth, etc.) and the included script implements matching commands for generating, validating, formatting, linting, exporting and similar operations.
Instruction Scope
SKILL.md describes command usage but does not mention that the shipped script persistently logs all command inputs. scripts/script.sh records inputs (timestamp|input) into files under $HOME/.local/share/swagger-generator and provides export/search features; this is within the skill's functional scope but is an implementation detail users should be aware of because it can capture sensitive text the user passes to the tool.
Install Mechanism
No install spec and no external downloads; the skill is instruction-plus-a-local-shell-script only, so nothing is fetched from third-party hosts at install time.
Credentials
The skill requests no environment variables or credentials (none declared). However, the script persists arbitrary user inputs to a local data directory; if users include credentials or tokens in endpoint descriptions, those will be stored on disk. There are no requests for unrelated external credentials.
Persistence & Privilege
The script creates and writes to $HOME/.local/share/swagger-generator (history.log and per-command .log files) and can export those logs to JSON/CSV/TXT. always:false and no elevated privileges. Persistence is limited to the user's home directory, but it does retain copies of provided inputs until deleted.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install swagger-generator
  3. After installation, invoke the skill by name or use /swagger-generator
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v2.0.1
update
v2.0.0
v2.5 standard: Use-when desc, homepage, source, security fix
v2.3.4
old template -> domain-specific v2.0.0
v2.3.3
old template -> domain-specific v2.0.0
v2.3.2
Quality upgrade
v2.3.1
Quality upgrade: custom functionality
v2.3.0
Quality fixes: aligned docs with implementation
v2.2.0
Enhanced descriptions for better AI triggering
v0.0.1
c
v1.0.0
Initial release of swagger-generator — a tool for generating OpenAPI 3.0/Swagger specifications. - Supports full OpenAPI 3.0 spec generation in YAML/JSON - Generates endpoints, models, authentication schemes, error responses, and server configs - Includes commands for CRUD, single endpoint, and model generation - Provides grouping via tags, pagination support, and example values - Usable with Swagger UI, Redoc, and Postman
Metadata
Slug swagger-generator
Version 2.0.1
License MIT-0
All-time Installs 1
Active Installs 1
Total Versions 10
Frequently Asked Questions

What is Swagger Generator?

Generate OpenAPI 3.0 specs from endpoint descriptions. Use when validating APIs, generating docs, formatting YAML, checking schemas, linting contracts. It is an AI Agent Skill for Claude Code / OpenClaw, with 370 downloads so far.

How do I install Swagger Generator?

Run "/install swagger-generator" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Swagger Generator free?

Yes, Swagger Generator is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Swagger Generator support?

Swagger Generator is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Swagger Generator?

It is built and maintained by bytesagain4 (@xueyetianya); the current version is v2.0.1.

💬 Comments