← 返回 Skills 市场
Swagger Generator
作者
bytesagain4
· GitHub ↗
· v2.0.1
· MIT-0
370
总下载
0
收藏
1
当前安装
10
版本数
在 OpenClaw 中安装
/install swagger-generator
功能描述
Generate OpenAPI 3.0 specs from endpoint descriptions. Use when validating APIs, generating docs, formatting YAML, checking schemas, linting contracts.
安全使用建议
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.
功能分析
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.
能力评估
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.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install swagger-generator - 安装完成后,直接呼叫该 Skill 的名称或使用
/swagger-generator触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
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
元数据
常见问题
Swagger Generator 是什么?
Generate OpenAPI 3.0 specs from endpoint descriptions. Use when validating APIs, generating docs, formatting YAML, checking schemas, linting contracts. 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 370 次。
如何安装 Swagger Generator?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install swagger-generator」即可一键安装,无需额外配置。
Swagger Generator 是免费的吗?
是的,Swagger Generator 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
Swagger Generator 支持哪些平台?
Swagger Generator 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 Swagger Generator?
由 bytesagain4(@xueyetianya)开发并维护,当前版本 v2.0.1。
推荐 Skills