Swagger agent skills for Claude Code, Cursor and RevampKey

5 ready-made playbooks that teach an AI agent how to do real Swagger work: which tools to call, what to check first, and when to stop and ask you.

Download RevampKey, free I have it: connect Swagger

Connect Swagger once and all 5 skills install themselves and stay up to date. Mac, Windows and Linux.

All 5 Swagger skills

Each skill is one job. You ask in plain words and the agent loads the skill that matches, then follows its steps.

Start hereAsks before writing22 Swagger tools

Use the Swagger connector safely with AI

Explains how to connect the SmartBear Swagger remote server, choose between Portal and Studio tools, search large catalogues and get approval before any change.

Use it when

You have just connected Swagger and want to know what it can do
A search of your API catalogue returned too much to read at once
Swagger reports a permission error and you need to know why

Tools it uses

list_portals
get_portal
list_portal_products
get_portal_product
list_portal_product_sections
list_table_of_contents
get_document
search_apis_and_domains
get_api_definition
scan_api_standardization
create_api_from_prompt
create_portal
update_portal
create_portal_product
update_portal_product
delete_portal_product
publish_portal_product
create_table_of_contents
delete_table_of_contents
update_document
create_or_update_api
standardize_api

Example

Connect to Swagger and find the Payments API, but don't change anything yet.

Connected to the Swagger account you signed in with. Searching for "Payments" returned 3 APIs: Payments v1, Payments v2 and Payments Sandbox. I've read the summaries only. Nothing has been changed, and publishing or editing will wait for your explicit yes.

Use in RevampKeyRead the full skill →

Asks before writing6 Swagger tools

Audit your API definitions with AI

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.

Use it when

Before publishing an API to a developer portal, to see what would confuse consumers
When a team asks which APIs in the catalogue are not up to standard
After a standardisation pass, to check what is still outstanding

Tools it uses

search_apis_and_domains
get_api_definition
scan_api_standardization
standardize_api
create_or_update_api
create_api_from_prompt

Example

Audit the payments APIs in our Swagger catalogue and tell me which ones have high-severity problems.

I checked 12 of the 14 payments APIs. The scan passed 9 and failed 3. Two definitions could not be retrieved, so they are listed separately. Three APIs have high-severity findings: the refunds endpoint is missing authentication on its write operation, and two responses do not match their schemas. The most common low-severity problem is mixed naming style, which appears in 7 APIs. I changed nothing.

Use in RevampKeyRead the full skill →

Asks before writing5 Swagger tools

Design an API definition from a brief

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.

Use it when

You have an idea for a new API and want a first draft definition
A product brief needs to become something engineers can review
You want to see standardisation issues before a new API is shared

Tools it uses

create_api_from_prompt
get_api_definition
scan_api_standardization
create_or_update_api
standardize_api

Example

Draft an API for managing customer returns: customers request a return, staff approve it, and the refund status can be checked. Ask me anything unclear first.

Before drafting I need to confirm consumers and auth. I have a draft with three resources (returns, return items, refunds) and eight operations. The scan flagged inconsistent error shapes and two undecided items: auth scheme and pagination. Shall I save it as return-management v0.1 once you approve?

Use in RevampKeyRead the full skill →

Asks before writing5 Swagger tools

Clean up an API definition to standard with Swagger AI

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.

Use it when

A definition fails the team's standards check and needs fixing before release
You want mechanical lint issues fixed without touching client-facing contracts
You need a before-and-after record of what changed and why

Tools it uses

search_apis_and_domains
get_api_definition
scan_api_standardization
standardize_api
create_or_update_api

Example

Clean up the Payments API definition so it passes our standardisation check, but don't break any existing clients.

I scanned Payments API: 2 structural errors, 14 mechanical violations and 1 design issue. I propose fixing the 14 mechanical items, such as missing descriptions and casing on new fields, and the 2 structural errors. The design issue, a renamed path, is breaking, so I've left it for your decision. Shall I apply the safe group?

Use in RevampKeyRead the full skill →

Asks before writing14 Swagger tools

Prepare and publish a Swagger developer portal product

Reviews a Swagger developer portal product's structure and documents, proposes fixes, and publishes only the exact product and sections you approve.

Use it when

Before releasing a new API product to external developers
When a portal page or table of contents needs tidying up
When checking what developers will see before a product goes live

Tools it uses

list_portals
get_portal
list_portal_products
get_portal_product
list_portal_product_sections
list_table_of_contents
get_document
update_document
update_portal_product
create_portal_product
create_table_of_contents
delete_table_of_contents
publish_portal_product
delete_portal_product

Example

Review the Payments product on our developer portal, fix any broken sections, and publish it once I've approved the changes.

I checked the Payments product on the Partner portal. The table of contents has one dead entry, and the overview still names v2 while the reference is v3. I've listed three proposed edits for your approval. Nothing is live yet; once you approve the edits I'll re-read the pages, then ask for a separate yes before publishing the Payments product.

Use in RevampKeyRead the full skill →

Get all 5 without copying a file

RevampKey adds the skills when you connect Swagger, updates them for you and removes them when you disconnect.

Download RevampKey

How Swagger skills work

Connect Swagger
The Swagger MCP server gives the agent its tools.
Ask in plain words
“Audit the payments APIs in our Swagger catalogue and tell me which ones have high-severity problems.” Each SKILL.md says when it applies, so only the one that fits is loaded.
Approve any change
The agent calls the tools in order, checks its work, and shows you any change before it makes it.

How to install Swagger skills

In RevampKey the skills install themselves when you connect Swagger. In other tools each skill is one folder with a SKILL.md file, and you also need the Swagger MCP server connected there.

About 1 minute · nothing to copy

Download RevampKey for Mac, Windows or Linux and sign in.
Open Connectors and connect Swagger. All 5 skills come with it and stay up to date; they go away when you remove the connector.
Ask in plain language, for example “Audit the payments APIs in our Swagger catalogue and tell me which ones have high-severity problems.”
Download RevampKeyConnect Swagger · 1 click
Get RevampKey to connect Swagger
RevampKey is a free desktop app for Mac, Windows and Linux. Install it, sign in, and Swagger is one click away with its skills already attached.
Download RevampKey
Not now? Use the skills in your current tool
for s in essentials api-definition-audit api-design-from-brief api-standardisation-cleanup developer-portal-publishing; do curl -fsSL --create-dirs -o .claude/skills/swagger-$s/SKILL.md https://revampkey.com/marketplace/swagger/skills/$s/SKILL.md done
Other tools

Into this project’s .claude/skills folder

Connect the Swagger MCP server in Claude Code.

Run this in your project folder to add all 5 skills:

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

Ask in plain language, for example “Audit the payments APIs in our Swagger catalogue and tell me which ones have high-severity problems.”

Into the shared .agents/skills folder

Connect the Swagger MCP server in Cursor.

Run this in your project folder to add all 5 skills:

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

Ask in plain language, for example “Audit the payments APIs in our Swagger catalogue and tell me which ones have high-severity problems.”

Into the shared .agents/skills folder

Connect the Swagger MCP server in Codex.

Run this in your project folder to add all 5 skills:

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

Ask in plain language, for example “Audit the payments APIs in our Swagger catalogue and tell me which ones have high-severity problems.”

Into the shared .agents/skills folder

Connect the Swagger MCP server in VS Code.

Run this in your project folder to add all 5 skills:

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

Ask in plain language, for example “Audit the payments APIs in our Swagger catalogue and tell me which ones have high-severity problems.”

RevampKey or copy the files?

In RevampKey

One click when you connect Swagger
Updated for you when a skill improves
Removed when you disconnect
The MCP server is set up for you
800+ other connectors, same way

Download free

Copy into your project

One command per project
Run it again to get updates
You connect the Swagger MCP server yourself
Works in Claude Code, Cursor, Codex and VS Code

See the command

Swagger skills FAQ

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.

Swagger MCP server setup · This page as Markdown

Put Swagger’s best workflows in your agent

Download RevampKey, connect Swagger and ask your first question in about a minute.

Download RevampKey Connect Swagger · 1 click

All 5 Swagger skills

Use the Swagger connector safely with AI

Use it when

Tools it uses

Audit your API definitions with AI

Use it when

Tools it uses

Design an API definition from a brief

Use it when

Tools it uses

Clean up an API definition to standard with Swagger AI

Use it when

Tools it uses

Prepare and publish a Swagger developer portal product

Use it when

Tools it uses

Get all 5 without copying a file

How Swagger skills work

How to install Swagger skills

RevampKey or copy the files?

In RevampKey

Copy into your project

Swagger skills FAQ

Put Swagger’s best workflows in your agent

Skills for related tools