Control macOS via CLI using MacPilot for automating UI actions, managing windows, handling file dialogs, capturing screenshots, and system tasks.
# MacPilot Skills Agent skills for [MacPilot](https://github.com/adhikjoshi/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 ```bash npx skills add adhikjoshi/macpilot-skills ``` This uses the [skills](https://github.com/vercel-labs/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 1. **MacPilot installed** — Build from source or download from [releases](https://github.com/adhikjoshi/macpilot/releases) 2. **Accessibility permission** — Grant MacPilot.app access in System Settings > Privacy & Security > Accessibility 3. **Screen Recording permission** (for screenshot/OCR skills) — Grant in System Settings > Privacy & Security > Screen Recording ## Quick Start ```bash # 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: ```bash # 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
don't have the plugin yet? install it then click "run inline in claude" again.