← Back to Skills Marketplace
Openapi Spec
by
codenova58
· GitHub ↗
· v1.0.0
· MIT-0
242
Downloads
1
Stars
2
Active Installs
1
Versions
Install in OpenClaw
/install openapi-spec
Description
Deep OpenAPI workflow—design-first vs code-first, reusable schemas, security schemes, errors, examples, linting, compatibility, and codegen. Use when documen...
Usage Guidance
This skill is a documentation-only guidance pack for OpenAPI workflows and appears internally consistent. Before installing, consider: (1) the source is unknown—verify the publisher if provenance matters; (2) later steps you follow (e.g., running codegen, CI linters, or publishing) may require third-party tools, API keys, or network access—those will be separate actions outside this skill; and (3) as with any skill, review any future code or install steps it suggests before executing them.
Capability Analysis
Type: OpenClaw Skill
Name: openapi-spec
Version: 1.0.0
The skill bundle contains high-level procedural guidance for an AI agent to assist users with OpenAPI specification design and documentation. The content in SKILL.md is purely instructional, focusing on standard API development workflows, versioning, and security schemes without any executable code, data exfiltration attempts, or malicious prompt injection.
Capability Assessment
Purpose & Capability
Name and description match the SKILL.md content: a multi-stage OpenAPI design/linting/codegen workflow. The skill does not request unrelated binaries, environment variables, or config paths.
Instruction Scope
SKILL.md contains only guidance, checklists, and best practices for OpenAPI workflows. It does not instruct the agent to read files, access environment variables, call external endpoints, or run shell commands.
Install Mechanism
No install spec or code files are present. Being instruction-only means nothing is written to disk or downloaded at install time.
Credentials
No environment variables, credentials, or config paths are required or referenced; this is proportional for a documentation/workflow guidance skill.
Persistence & Privilege
always is false and model invocation is allowed (default). The skill does not request permanent presence or attempt to modify other skills or system settings.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install openapi-spec - After installation, invoke the skill by name or use
/openapi-spec - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the OpenAPI Spec skill with a detailed, stage-based workflow for REST API specification.
- Covers design-first vs code-first, ownership, versioning, RESTful conventions, reusable schemas, security schemes, error patterns, linting, and compatibility checks.
- Provides a practical final review checklist and best practices for robust API contracts.
- Includes guidance for handling deviations (e.g., using GraphQL elsewhere) and tips for maintaining examples and schema consistency.
Metadata
Frequently Asked Questions
What is Openapi Spec?
Deep OpenAPI workflow—design-first vs code-first, reusable schemas, security schemes, errors, examples, linting, compatibility, and codegen. Use when documen... It is an AI Agent Skill for Claude Code / OpenClaw, with 242 downloads so far.
How do I install Openapi Spec?
Run "/install openapi-spec" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Openapi Spec free?
Yes, Openapi Spec is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Openapi Spec support?
Openapi Spec is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Openapi Spec?
It is built and maintained by codenova58 (@codenova58); the current version is v1.0.0.
More Skills