MacPilot Skills
Agent skills for MacPilot — a CLI tool for macOS automation via Accessibility APIs.
These skills teach AI coding agents (Claude Code, Cursor, Codex, etc.) how to use MacPilot to automate macOS tasks: clicking buttons, typing text, managing windows, handling file dialogs, taking screenshots, and more.
Install
npx skills add adhikjoshi/macpilot-skills
This uses the skills CLI to install skills into your agent of choice.
Available Skills
| Skill | Description |
|---|---|
| macpilot-automation | Core macOS automation — mouse, keyboard, apps, menus, clipboard (with history & search), notifications, shell, system controls |
| macpilot-ui-inspector | Inspect and interact with UI elements via accessibility APIs — find, click, read, and modify controls |
| macpilot-dialog-handler | Handle native file dialogs (Open, Save, Print) — navigate folders, select files, dismiss alerts, wait-for & click-primary |
| macpilot-screenshot-ocr | Capture screenshots, OCR click (find & click text on screen), screen recording with pause/resume |
| macpilot-window-manager | Manage windows — list, move, resize, snap, fullscreen, Spaces, save/restore layouts |
Prerequisites
- MacPilot installed — Build from source or download from releases
- Accessibility permission — Grant MacPilot.app access in System Settings > Privacy & Security > Accessibility
- Screen Recording permission (for screenshot/OCR skills) — Grant in System Settings > Privacy & Security > Screen Recording
Quick Start
# Install MacPilot skills into Claude Code
npx skills add adhikjoshi/macpilot-skills
# Now ask Claude Code to automate macOS:
# "Open Safari and navigate to example.com"
# "Take a screenshot of the Finder window"
# "Snap VS Code to the left half and Terminal to the right"
# "Save this file to my Desktop"
Manual Install
If you prefer not to use npx skills, copy any SKILL.md file to your agent's skills directory:
# Claude Code (project scope)
mkdir -p .claude/skills/macpilot-automation
cp skills/macpilot-automation/SKILL.md .claude/skills/macpilot-automation/
# Claude Code (global scope)
mkdir -p ~/.claude/skills/macpilot-automation
cp skills/macpilot-automation/SKILL.md ~/.claude/skills/macpilot-automation/
License
MIT