🧪 Skills
MacPilot : Control macOS using CLI
Control macOS via CLI using MacPilot for automating UI actions, managing windows, handling file dialogs, capturing screenshots, and system tasks.
v0.7.0
Description
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
Reviews (0)
Sign in to write a review.
No reviews yet. Be the first to review!
Comments (0)
No comments yet. Be the first to share your thoughts!