macos-automation

Use this agent when the user wants to automate macOS native apps or expresses intent to script Apple applications (Mail, Calendar, Notes, Reminders). The agent proactively triggers to design and build automation solutions. <example> Context: User mentions email workflow user: "I need to check my unread emails and summarize them" assistant: *automation-builder agent activates* "I'll help you automate reading from Apple Mail. Let me build a solution that fetches your unread emails." <commentary> User wants to access email data. Trigger automation-builder to create Mail.app automation using JXA patterns from mail-automation skill. </commentary> </example> <example> Context: User discussing daily productivity user: "Can you create something that shows my calendar and reminders for today?" assistant: *automation-builder agent activates* "I'll build a daily briefing that pulls from Calendar and Reminders. This will combine JXA for Calendar and Swift CLI for Reminders." <commentary> Multi-app automation request. Trigger automation-builder to combine calendar-automation and reminders-automation patterns into unified solution. </commentary> </example> <example> Context: User mentions notes organization user: "I want to search my notes for anything related to this project" assistant: *automation-builder agent activates* "I'll create a Notes.app search automation that finds relevant notes and returns their content." <commentary> User wants to query Notes app. Trigger automation-builder to create search functionality using notes-automation skill patterns. </commentary> </example> <example> Context: User building a workflow user: "Help me create a script that drafts an email based on my calendar for tomorrow" assistant: *automation-builder agent activates* "I'll build an automation that reads tomorrow's calendar events and creates an email draft in Mail.app with the schedule summary." <commentary> Cross-app automation combining calendar and mail. Trigger automation-builder to integrate calendar-automation and mail-automation patterns. </commentary> </example> <example> Context: User wants email automation user: "Can you read my inbox and show me the unread messages?" assistant: *automation-builder agent activates* "I'll create a Mail automation to fetch and display your unread messages." <commentary> Simple Mail.app request. Trigger automation-builder to apply mail-automation patterns. </commentary> </example>

This skill should be used when the user asks to "automate Calendar", "read calendar events", "create calendar events", "check today's schedule", "find meetings", "add appointments", "access calendars programmatically", or mentions Calendar.app automation, event scripting, or macOS calendar workflows.

This skill should be used when the user asks to "automate macOS", "use AppleScript", "write JXA", "automate Mac apps", "script Apple applications", "use osascript", "run JavaScript for Automation", or needs guidance on macOS automation fundamentals, TypeScript/Bun integration patterns, or choosing between AppleScript and JXA.

This skill should be used when the user asks to "automate Apple Mail", "read emails programmatically", "create email drafts", "check unread count", "send email from Mail app", "access mailboxes", "search inbox", "filter messages", or mentions Mail.app automation, email scripting, or macOS email workflows.

This skill should be used when the user asks to "automate Notes app", "read notes programmatically", "create notes", "search notes", "access note folders", "get note content", or mentions Notes.app automation, note scripting, or macOS notes workflows.

This skill should be used when the user asks to "automate Reminders", "read reminders programmatically", "create reminders", "check due tasks", "access reminder lists", "mark reminders complete", or mentions Reminders.app automation. Note that full functionality requires Swift CLI with EventKit since AppleScript/JXA access to Reminders is severely limited.