# Port IO agent skills for Claude Code, Cursor and RevampKey

> Ready-made Port IO playbooks for AI agents: audit your Port IO catalog model, check scorecard readiness in Port IO. Free SKILL.md files for Claude Code, Cursor and Codex, or one click in RevampKey.

## Skills

- [Use the Port IO connector safely](https://revampkey.com/marketplace/port-io/skills/essentials.md): 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.
- [Audit your Port IO catalog model](https://revampkey.com/marketplace/port-io/skills/catalog-model-audit.md): 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.
- [Check scorecard readiness in Port IO](https://revampkey.com/marketplace/port-io/skills/scorecard-readiness-check.md): 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.

## Install

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

```bash
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
```

### 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.

MCP setup guide: https://revampkey.com/marketplace/port-io.md
