Skip to content
TrustedSkillsbeta
Back to all skills

Openapi Spec Generation

Listed
sickn33·vlatest·backend·MIT

Generates OpenAPI specifications from existing codebases or natural language descriptions for API documentation and automation.

Repository

Install on your platform

Showing Claude Code. One command installs this skill into any of the agents below.

  1. 1

    Run this in your project

    terminal
    $ npx skills add sickn33/agentic-awesome-skills --skill openapi-spec-generation -a claude-code

  2. Uses the open-source skills CLI and needs Node.js. Add -g to install it for your user instead of this project.

What we know about this skill

Publisher

sickn33

Taken from the source listing. We haven't verified who controls this account.

Install target

Live repository

Not pinned. Installing fetches whatever the repository holds at the time you run the command.

No human has reviewed this code. The checks below are a static scan of the files at one commit — nobody has run this skill or judged whether it works. A skill runs with whatever access you give your agent, so read the source before you install it.

Automated safety checks

scanned

This skill failed 1 of 6 checks. A failure is not proof of bad intent; it means something in the code needs a human to look at it before you run it.

  • Declares what it does: failed

    No SKILL.md was found in the skill's directory.

    SKILL.md exists, its frontmatter parses, and it declares a name and a description.

  • No undeclared network calls: passed

    Makes no network calls.

    Every host the skill dials — from its scripts, its config endpoints or the commands it tells the agent to run — is either well-known package and API infrastructure or declared in its own frontmatter. Links in documentation are not counted.

  • No obfuscated payloads: passed

    No encoded or obfuscated payloads.

    No base64, hex or compressed blob is decoded and then executed, and no encoded shell commands.

  • No credential access: passed

    Reads no keys, tokens, keychains or credential files.

    Neither the code nor the SKILL.md instructions read SSH keys, cloud credentials, keychains, token stores, browser cookie databases or dotfiles that hold secrets.

  • No pipe-to-shell installers: passed

    No pipe-to-shell or download-and-run installers.

    No `curl … | sh` pattern, in the code or in the instructions, that runs code fetched at run time.

  • Pinned to a commit: passed

    Scanned sickn33/antigravity-awesome-skills at 5a4cdd9df8.

    The exact upstream commit SHA that was scanned is recorded, so the result refers to specific bytes.

Commit
5a4cdd9df8
Manifest
skills/openapi-spec-generation/SKILL.md
Scanned
0 files
Copies in repo
3 — all of them scanned
This is a static scan, not a review. It reads the skill's files; it does not run them, and it cannot tell you whether the skill is any good or whether the code does what its description says. A skill runs with whatever access you give your agent.
What each check looks for →

About this skill

The openapi-spec-generation skill allows AI agents to automatically create OpenAPI specification files based on provided API descriptions or code snippets. It streamlines the process of defining RESTful interfaces, ensuring consistent documentation and contract validation for backend services.

When to use it

  • Rapidly prototype new API endpoints without manually writing YAML or JSON definitions.
  • Generate standard documentation from existing function signatures or route handlers.
  • Validate that AI-generated code adheres to a specific OpenAPI schema structure.
  • Accelerate frontend-backend integration by providing immediate interface contracts.

Key capabilities

  • Converts natural language API descriptions into structured OpenAPI specs.
  • Parses source code snippets to extract endpoint details and parameters.
  • Outputs standard OpenAPI format (YAML or JSON) ready for import into tools like Swagger UI.

Example prompts

  • "Generate an OpenAPI specification for a user authentication service with login, logout, and profile update endpoints."
  • "Create an OpenAPI spec based on this Python Flask route handler code snippet."
  • "Define the API contract for a weather data retrieval service that accepts latitude and longitude parameters."

Tips & gotchas

Ensure you provide clear context about the expected request/response formats to avoid generic or inaccurate schema generation. The output may require manual refinement if complex business logic isn't explicitly described in your input.