MacOS agent skills for Claude Code, Cursor and RevampKey

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

Download RevampKey, free I have it: connect MacOS

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

All 3 MacOS skills

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

Start hereRead-only1 MacOS tools

Use macOS-MCP safely and well

Guides an AI agent through controlling a Mac with macOS-MCP: confirming the machine and permissions, choosing the right tool, working from fresh screen snapshots, and asking before anything clicks, types, runs a command or sends a notification.

Use it when

You want an AI assistant to operate apps on your Mac
You need to set up or troubleshoot Accessibility and Screen Recording permissions
You are not sure which macOS-MCP tool to use for a task

Tools it uses

Snapshot

Example

Take a snapshot of my screen and tell me which app is in front, then wait for my go-ahead before clicking anything.

The frontmost app is Mail, with an open message titled "Quarterly figures" in the reading pane. I have not clicked or typed anything. Tell me if you want me to reply, and I will draft the text and show it to you before sending.

Use in RevampKeyRead the full skill →

Asks before writing10 MacOS tools

Automate multi-app tasks on your Mac with AI

Runs a multi-step task across real Mac apps by taking a snapshot, acting, waiting and checking the result at each step. It stops on unexpected dialogs and asks before any step that sends, submits, deletes or overwrites.

Use it when

Copy a figure from one app into a form in another and confirm it matches
Click through a repeated export or import workflow across several windows
Open an app, find a record and update one field, then check the saved value

Tools it uses

Snapshot
App
Click
Type
Scroll
Move
Shortcut
Shell
Notification
Wait

Example

Open the billing app, copy the March invoice total into the budget spreadsheet, and check that the two numbers match.

I opened the billing app and found the March invoice showing a total of 4,280.50. I entered it into row 12 of the budget sheet and re-read the cell to confirm it reads 4,280.50. I have not saved or sent anything yet; the sheet change is ready for your yes.

Use in RevampKeyRead the full skill →

Read-only5 MacOS tools

Audit what's on your Mac screen with AI

Captures a snapshot of the current desktop, reads visible status and dialogs, and reports what is on screen and what the machine is doing. It is read-only and never clicks, types or changes anything without asking.

Use it when

You want to know whether an error or dialog is currently showing
You need a report of which app and window are in front before doing anything else
You want to compare the screen now with a moment ago without touching it

Tools it uses

App
Snapshot
Wait
Scrape
Shell

Example

What's on my screen right now? Is there any dialog or error waiting for me?

The front app is Mail, in a compose window. A 'Send failed: no connection' alert is blocking it, so the draft has not gone out. I did not click the alert; you can dismiss it or tell me to retry.

Use in RevampKeyRead the full skill →

Get all 3 without copying a file

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

Download RevampKey

How MacOS skills work

Connect MacOS
The MacOS MCP server gives the agent its tools.
Ask in plain words
“Open the billing app, copy the March invoice total into the budget spreadsheet, and check that the two numbers match.” 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 MacOS skills

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

About 1 minute · nothing to copy

Download RevampKey for Mac, Windows or Linux and sign in.
Open Connectors and connect MacOS. 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 “Open the billing app, copy the March invoice total into the budget spreadsheet, and check that the two numbers match.”
Download RevampKeyConnect MacOS · 1 click
Get RevampKey to connect MacOS
RevampKey is a free desktop app for Mac, Windows and Linux. Install it, sign in, and MacOS is one click away with its skills already attached.
Download RevampKey
Not now? Use the skills in your current tool
for s in essentials desktop-task-automation ui-state-audit; do curl -fsSL --create-dirs -o .claude/skills/macos-mcp-$s/SKILL.md https://revampkey.com/marketplace/macos-mcp/skills/$s/SKILL.md done
Other tools

Into this project’s .claude/skills folder

Connect the MacOS MCP server in Claude Code.

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

for s in essentials desktop-task-automation ui-state-audit; do
  curl -fsSL --create-dirs -o .claude/skills/macos-mcp-$s/SKILL.md https://revampkey.com/marketplace/macos-mcp/skills/$s/SKILL.md
done

Ask in plain language, for example “Open the billing app, copy the March invoice total into the budget spreadsheet, and check that the two numbers match.”

Into the shared .agents/skills folder

Connect the MacOS MCP server in Cursor.

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

for s in essentials desktop-task-automation ui-state-audit; do
  curl -fsSL --create-dirs -o .agents/skills/macos-mcp-$s/SKILL.md https://revampkey.com/marketplace/macos-mcp/skills/$s/SKILL.md
done

Ask in plain language, for example “Open the billing app, copy the March invoice total into the budget spreadsheet, and check that the two numbers match.”

Into the shared .agents/skills folder

Connect the MacOS MCP server in Codex.

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

for s in essentials desktop-task-automation ui-state-audit; do
  curl -fsSL --create-dirs -o .agents/skills/macos-mcp-$s/SKILL.md https://revampkey.com/marketplace/macos-mcp/skills/$s/SKILL.md
done

Ask in plain language, for example “Open the billing app, copy the March invoice total into the budget spreadsheet, and check that the two numbers match.”

Into the shared .agents/skills folder

Connect the MacOS MCP server in VS Code.

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

for s in essentials desktop-task-automation ui-state-audit; do
  curl -fsSL --create-dirs -o .agents/skills/macos-mcp-$s/SKILL.md https://revampkey.com/marketplace/macos-mcp/skills/$s/SKILL.md
done

Ask in plain language, for example “Open the billing app, copy the March invoice total into the budget spreadsheet, and check that the two numbers match.”

RevampKey or copy the files?

In RevampKey

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

See the command

MacOS skills FAQ

What is a MacOS agent skill?

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

Do the MacOS skills change anything on their own?

2 of the 3 only read. The others tell the agent to show you the change and wait for a yes before it creates, edits or deletes anything in MacOS.

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

Do I need the MacOS MCP server too?

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

MacOS MCP server setup · This page as Markdown

Put MacOS’s best workflows in your agent

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

Download RevampKey Connect MacOS · 1 click

All 3 MacOS skills

Use macOS-MCP safely and well

Use it when

Tools it uses

Automate multi-app tasks on your Mac with AI

Use it when

Tools it uses

Audit what's on your Mac screen with AI

Use it when

Tools it uses

Get all 3 without copying a file

How MacOS skills work

How to install MacOS skills

RevampKey or copy the files?

In RevampKey

Copy into your project

MacOS skills FAQ

Put MacOS’s best workflows in your agent

Skills for related tools