← Back to Skills Marketplace
openapi-parser
by
Kevin Rohan Vaz
· GitHub ↗
· v1.0.0
· MIT-0
75
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install openapi-parser
Description
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...
Usage Guidance
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.
Capability Analysis
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.
Capability Tags
Capability Assessment
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.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openapi-parser - After installation, invoke the skill by name or use
/openapi-parser - Provide required inputs per the skill's parameter spec and get structured output
Version History
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.
Metadata
Frequently Asked Questions
What is 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... It is an AI Agent Skill for Claude Code / OpenClaw, with 75 downloads so far.
How do I install openapi-parser?
Run "/install openapi-parser" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is openapi-parser free?
Yes, openapi-parser is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does openapi-parser support?
openapi-parser is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created openapi-parser?
It is built and maintained by Kevin Rohan Vaz (@kevinrvaz); the current version is v1.0.0.
More Skills