Port IO agent skills for Claude Code, Cursor and RevampKey

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

Download RevampKey, free I have it: connect Port IO

Connect Port IO once and all 3 skills install themselves and stay up to date. Mac, Windows and Linux.

All 3 Port IO 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 writing12 Port IO tools

Use the Port IO connector safely

Guides the agent through Port IO: confirming the organisation and region, reading blueprints, entities, scorecards and actions efficiently, and asking before any change or action run.

Use it when

A user asks what is in their Port software catalog
A user wants to look up or search entities in Port
A user asks the agent to update Port or run an action

Tools it uses

list_blueprints
list_entities
list_scorecards
list_actions
search_port_knowledge_sources
list_integrations
load_skill
upsert_blueprint
upsert_entity
upsert_scorecard
upsert_action
run_action

Example

Show me the services in our Port catalog that have no owner set.

I'll confirm your organisation and region first, then check the Service blueprint's entities. Two services in the first page have no owner set. The list is complete for that page, and there are more pages to load if you want the full set.

Use in RevampKeyRead the full skill →

Asks before writing8 Port IO tools

Audit your Port IO catalog model

Reviews your Port blueprints, entities and scorecards for orphans, missing ownership and inconsistent values, and reports findings by severity. It is read-only and changes nothing.

Use it when

A catalog has grown messy and you need to know what is wrong first
You want to check ownership gaps before a platform review
You suspect duplicate or unused blueprints and want evidence

Tools it uses

list_blueprints
list_entities
list_scorecards
upsert_blueprint
upsert_entity
upsert_scorecard
upsert_action
run_action

Example

Audit my Port catalog and tell me what's broken in the model.

Scope: EU org, 14 blueprints, 320 entities, 6 scorecards. High: 41 services have no owner; examples checkout-api, search-worker. Medium: environment is written as prod, production and Prod across 3 blueprints. Low: 2 blueprints have no entities. Nothing was changed.

Use in RevampKeyRead the full skill →

Asks before writing6 Port IO tools

Check scorecard readiness in Port IO

Works out which scorecard level an entity holds, which rule is blocking the next level, and which catalog action could close the gap. It reports first and asks before changing anything.

Use it when

A service is failing its production readiness scorecard and the team wants to know why.
An entity is stuck at a lower level and the gating rule is unclear.
Someone wants a short plan to move a service up one scorecard level.

Tools it uses

list_entities
list_scorecards
list_actions
search_port_knowledge_sources
load_skill
run_action

Example

Is the payments-api service ready for the next scorecard level in Port, and what would it take?

payments-api is at Silver and needs 2 more rules for Gold. The gating rule is a missing on-call team relation, which is closable by linking the existing platform team. The other gap, a test coverage property, needs a human decision because no test suite is recorded. I have proposed the link but not run it; say yes to apply it.

Use in RevampKeyRead the full skill →

Get all 3 without copying a file

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

Download RevampKey

How Port IO skills work

Connect Port IO
The Port IO MCP server gives the agent its tools.
Ask in plain words
“Audit my Port catalog and tell me what's broken in the model.” 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 Port IO skills

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

About 1 minute · nothing to copy

Download RevampKey for Mac, Windows or Linux and sign in.
Open Connectors and connect Port IO. All 3 skills come with it and stay up to date; they go away when you remove the connector.
Ask in plain language, for example “Audit my Port catalog and tell me what's broken in the model.”
Download RevampKeyConnect Port IO · 1 click
Get RevampKey to connect Port IO
RevampKey is a free desktop app for Mac, Windows and Linux. Install it, sign in, and Port IO is one click away with its skills already attached.
Download RevampKey
Not now? Use the skills in your current tool
for s in essentials catalog-model-audit scorecard-readiness-check; do curl -fsSL --create-dirs -o .claude/skills/port-io-$s/SKILL.md https://revampkey.com/marketplace/port-io/skills/$s/SKILL.md done
Other tools

Into this project’s .claude/skills folder

Connect the Port IO MCP server in Claude Code.

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

for s in essentials catalog-model-audit scorecard-readiness-check; do
  curl -fsSL --create-dirs -o .claude/skills/port-io-$s/SKILL.md https://revampkey.com/marketplace/port-io/skills/$s/SKILL.md
done

Ask in plain language, for example “Audit my Port catalog and tell me what's broken in the model.”

Into the shared .agents/skills folder

Connect the Port IO MCP server in Cursor.

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

for s in essentials catalog-model-audit scorecard-readiness-check; do
  curl -fsSL --create-dirs -o .agents/skills/port-io-$s/SKILL.md https://revampkey.com/marketplace/port-io/skills/$s/SKILL.md
done

Ask in plain language, for example “Audit my Port catalog and tell me what's broken in the model.”

Into the shared .agents/skills folder

Connect the Port IO MCP server in Codex.

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

for s in essentials catalog-model-audit scorecard-readiness-check; do
  curl -fsSL --create-dirs -o .agents/skills/port-io-$s/SKILL.md https://revampkey.com/marketplace/port-io/skills/$s/SKILL.md
done

Ask in plain language, for example “Audit my Port catalog and tell me what's broken in the model.”

Into the shared .agents/skills folder

Connect the Port IO MCP server in VS Code.

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

for s in essentials catalog-model-audit scorecard-readiness-check; do
  curl -fsSL --create-dirs -o .agents/skills/port-io-$s/SKILL.md https://revampkey.com/marketplace/port-io/skills/$s/SKILL.md
done

Ask in plain language, for example “Audit my Port catalog and tell me what's broken in the model.”

RevampKey or copy the files?

In RevampKey

One click when you connect Port IO
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 Port IO MCP server yourself
Works in Claude Code, Cursor, Codex and VS Code

See the command

Port IO skills FAQ

What is a Port IO agent skill?

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

Do the Port IO 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 Port IO.

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 Port IO; elsewhere you copy the folders into your project or skills directory.

Do I need the Port IO MCP server too?

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

Port IO MCP server setup · This page as Markdown

Put Port IO’s best workflows in your agent

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

Download RevampKey Connect Port IO · 1 click

All 3 Port IO skills

Use the Port IO connector safely

Use it when

Tools it uses

Audit your Port IO catalog model

Use it when

Tools it uses

Check scorecard readiness in Port IO

Use it when

Tools it uses

Get all 3 without copying a file

How Port IO skills work

How to install Port IO skills

RevampKey or copy the files?

In RevampKey

Copy into your project

Port IO skills FAQ

Put Port IO’s best workflows in your agent

Skills for related tools