# Swagger agent skills for Claude Code, Cursor and RevampKey

> Ready-made Swagger playbooks for AI agents: audit your API definitions with AI, design an API definition from a brief, clean up an API definition to standard with Swagger AI. Free SKILL.md files for Claude Code, Cursor and Codex, or one click in RevampKey.

## Skills

- [Use the Swagger connector safely with AI](https://revampkey.com/marketplace/swagger/skills/essentials.md): Explains how to connect the SmartBear Swagger remote server, choose between Portal and Studio tools, search large catalogues and get approval before any change.
- [Audit your API definitions with AI](https://revampkey.com/marketplace/swagger/skills/api-definition-audit.md): Reviews one API definition or a set of APIs in your Swagger catalogue for completeness, consistency and standardisation gaps, and reports them ranked by impact. It is read-only and changes nothing.
- [Design an API definition from a brief](https://revampkey.com/marketplace/swagger/skills/api-design-from-brief.md): Turns a plain-language description of an API into a draft definition, checks it against standardisation rules, and asks before saving anything to your catalogue.
- [Clean up an API definition to standard with Swagger AI](https://revampkey.com/marketplace/swagger/skills/api-standardisation-cleanup.md): Scans an API definition, proposes a fix list separating safe changes from breaking ones, and applies changes only after you approve each one. It re-scans afterwards to confirm the result.
- [Prepare and publish a Swagger developer portal product](https://revampkey.com/marketplace/swagger/skills/developer-portal-publishing.md): Reviews a Swagger developer portal product's structure and documents, proposes fixes, and publishes only the exact product and sections you approve.

## Install

- RevampKey: connect Swagger at https://revampkey.com/marketplace/swagger; the skills come with it.
- Any Agent Skills tool, into the current project:

```bash
for s in essentials api-definition-audit api-design-from-brief api-standardisation-cleanup developer-portal-publishing; do
  curl -fsSL --create-dirs -o .agents/skills/swagger-$s/SKILL.md https://revampkey.com/marketplace/swagger/skills/$s/SKILL.md
done
```

### What is a Swagger agent skill?

A SKILL.md file: a short playbook an AI agent loads when your request matches it. Each Swagger skill describes one job, which Swagger tools to use in which order, what to check first and when to stop and ask you.

### Do the Swagger skills change anything on their own?

The others tell the agent to show you the change and wait for a yes before it creates, edits or deletes anything in Swagger.

### Which tools can use these skills?

Any agent that reads the open Agent Skills format: Claude Code, Cursor, Codex, VS Code with Copilot and RevampKey. In RevampKey they are attached when you connect Swagger; elsewhere you copy the folders into your project or skills directory.

### Do I need the Swagger MCP server too?

Yes. The skills tell the agent how to do the work; the Swagger MCP server gives it the tools to do it. The Swagger MCP setup guide covers every client.

MCP setup guide: https://revampkey.com/marketplace/swagger.md