# MacOS agent skills for Claude Code, Cursor and RevampKey

> Ready-made MacOS playbooks for AI agents: automate multi-app tasks on your Mac with AI, audit what's on your Mac screen with AI. Free SKILL.md files for Claude Code, Cursor and Codex, or one click in RevampKey.

## Skills

- [Use macOS-MCP safely and well](https://revampkey.com/marketplace/macos-mcp/skills/essentials.md): 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.
- [Automate multi-app tasks on your Mac with AI](https://revampkey.com/marketplace/macos-mcp/skills/desktop-task-automation.md): 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.
- [Audit what's on your Mac screen with AI](https://revampkey.com/marketplace/macos-mcp/skills/ui-state-audit.md): 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.

## Install

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

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

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

MCP setup guide: https://revampkey.com/marketplace/macos-mcp.md