← 返回 Skills 市场
openapi-parser
作者
Kevin Rohan Vaz
· GitHub ↗
· v1.0.0
· MIT-0
75
总下载
0
收藏
0
当前安装
1
版本数
在 OpenClaw 中安装
/install openapi-parser
功能描述
Parses complex OpenAPI specs and generates Drift test cases from them. Use whenever the user wants to generate, write, or scaffold Drift tests from an OpenAP...
安全使用建议
This skill is coherent with its stated purpose: it helps you read OpenAPI specs and output Drift test YAML and asks for nothing sensitive. Before installing or invoking it, be aware that following its instructions may cause the agent to (1) read local spec files you point it to and (2) optionally fetch remote $ref URLs referenced by the spec — if those remote URLs are untrusted they could expose the agent to remote content. If you plan to run it, ensure the spec files you provide don't contain or reference secrets and that you are comfortable with the agent performing local file reads and occasional network fetches to resolve external $refs. If you want to avoid network activity, remove or vendor external $refs before running the skill.
功能分析
Type: OpenClaw Skill
Name: openapi-parser
Version: 1.0.0
The skill bundle provides instructions for an AI agent to execute shell commands (grep, find) and includes Lua script templates with network (http) and environment variable (os.getenv) access. While these capabilities are aligned with the stated purpose of parsing OpenAPI specifications and generating Drift tests, they represent high-risk behaviors and potential shell injection vulnerabilities (e.g., in SKILL.md and references/example-repos.md) if user-provided paths or parameters are not properly sanitized by the agent before execution.
能力标签
能力评估
Purpose & Capability
Name and description match the actual instructions: the SKILL.md describes how to locate endpoints, resolve $refs, enumerate schema variants, and emit Drift YAML. The skill declares no binaries, env vars, or installs — which is proportionate for an instruction-only parser/authoring helper.
Instruction Scope
Instructions are narrowly focused on parsing OpenAPI files and generating Drift operations/datasets. They include shell command examples (grep/Select-String) for locating spec fragments and an explicit policy for resolving $ref chains. One notable runtime behavior: external $refs may require fetching remote URLs (the doc says 'fetch the URL if needed'), which implies network access if the agent follows that step. The skill does not instruct the agent to read unrelated system files or secrets.
Install Mechanism
No install spec or bundled code — instruction-only. This minimizes installation risk; nothing is downloaded or written to disk by the skill itself.
Credentials
The skill requires no environment variables, credentials, or config paths. The SKILL.md references Drift dataset expressions and functions (e.g. ${functions:generate_uuid}), which are appropriate for producing Drift YAML and do not imply secret access.
Persistence & Privilege
The skill does not request persistent presence (always: false) and does not modify other skills or system-wide settings. Autonomous invocation is allowed by platform default and is not combined with other worrying privileges.
如何使用
- 确保已安装 OpenClaw(本地或 Docker 部署)
- 在对话框中输入安装命令:
/install openapi-parser - 安装完成后,直接呼叫该 Skill 的名称或使用
/openapi-parser触发 - 根据 Skill 的参数说明提供必要输入,即可获得结构化输出
版本历史
v1.0.0
- Initial release of the openapi-parser skill.
- Parses complex OpenAPI 3.x specs and generates Drift test cases, supporting advanced patterns like anyOf, oneOf, allOf, discriminators, polymorphism, inheritance, $ref chains, regex patterns, enums, and optional fields.
- Provides a clear workflow: extracting endpoint definitions, resolving $refs, enumerating schema combinations, and generating ready-to-paste Drift YAML for maximal test coverage.
- Includes detailed guides and references for mapping OpenAPI schema variants to Drift operations and datasets.
- Outputs include analysis, operations YAML, datasets (if needed), and notes on intentionally excluded schema combinations.
元数据
常见问题
openapi-parser 是什么?
Parses complex OpenAPI specs and generates Drift test cases from them. Use whenever the user wants to generate, write, or scaffold Drift tests from an OpenAP... 它是一个面向 Claude Code / OpenClaw 的 AI Agent Skill 插件,目前累计下载 75 次。
如何安装 openapi-parser?
在 OpenClaw 或 Claude Code 对话框中运行命令「/install openapi-parser」即可一键安装,无需额外配置。
openapi-parser 是免费的吗?
是的,openapi-parser 完全免费,采用 MIT-0 许可证,可自由下载、安装和使用。
openapi-parser 支持哪些平台?
openapi-parser 跨平台运行,可在任意部署了 OpenClaw / Claude Code 的环境中使用(cross-platform)。
谁开发了 openapi-parser?
由 Kevin Rohan Vaz(@kevinrvaz)开发并维护,当前版本 v1.0.0。
推荐 Skills