메뉴
Use when managing Apple Mail on macOS, especially to list accounts or mailboxes, inspect recent messages, search, read, mark, archive, move, or delete emails in Mail.app; also use it as the shared entry point for future Apple native app automation on this Mac.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
SOC 직업 분류 기준
Use when inspecting or upgrading managed local Codex skills against explicit upstream sources, or when syncing a Skills Manager central library across machines without re-deriving source mappings by hand.
Use when turning academic or medical-research materials into defense deliverables, including timed oral scripts, PPT speaker notes, narrative/storyline rewrites, reviewer-facing questions with background notes, or paired slide-notes plus script outputs. Trigger on PPT/PPTX plus source PDFs, thesis zip packages, proposal/application materials, dissertation defenses, project defenses, or requests such as "5-minute script", "speaker notes", "defense questions", "paced oral defense", or "storyline". Pair with Office/PPTX/PDF extraction skills for file operations.
| name | apple-apps |
| description | Use when managing Apple Mail on macOS, especially to list accounts or mailboxes, inspect recent messages, search, read, mark, archive, move, or delete emails in Mail.app; also use it as the shared entry point for future Apple native app automation on this Mac. |
This skill is the shared macOS-native app entry point. Right now it implements mail.* on top of Mail.app automation, with JSON output designed for agent workflows.
Do not use this skill for webmail sites opened in a browser.
The helper lives next to this skill at scripts/apple_apps.py.
Read-only commands:
python3 scripts/apple_apps.py mail accounts
python3 scripts/apple_apps.py mail mailboxes --account "iCloud"
python3 scripts/apple_apps.py mail recent --account "SYSU" --limit 1 --include-read
python3 scripts/apple_apps.py mail triage-meta --account "SYSU" --mailbox-path "INBOX" --limit 5 --include-read --on-date "2026-03-18"
python3 scripts/apple_apps.py mail search --account "SYSU" --query "invoice" --limit 20
python3 scripts/apple_apps.py mail search --account "SYSU" --query "Beta view" --limit 10 --include-read --include-body
python3 scripts/apple_apps.py mail read --id 141819 --account "SYSU" --mailbox-path "INBOX"
Mutation commands:
python3 scripts/apple_apps.py mail mark --id 141819 --account "SYSU" --mailbox-path "INBOX" --read true
python3 scripts/apple_apps.py mail move --id 141819 --account "SYSU" --mailbox-path "INBOX" --to-mailbox "Archive"
python3 scripts/apple_apps.py mail archive --id 141819 --account "SYSU" --mailbox-path "INBOX"
python3 scripts/apple_apps.py mail delete --id 141819 --account "SYSU" --mailbox-path "INBOX"
triage-meta.search.recent.id, account, and mailboxPath.read, mark, move, archive, or delete.triage-meta, which reads lightweight metadata from headers without loading message bodies.search now prefers lightweight thread-aware matching when --include-body is not set. It can use subject, sender, recipients, message ids, and reply-chain headers to return both direct hits and nearby thread context.search --include-body now uses a two-stage path: lightweight recall first, then body reads for only a small candidate set. This is much more practical for recent-thread recovery, but it is still not a full-mailbox text index.recent is still useful for quick one-message inspection, especially recent --account ... --limit 1 --include-read.read, mark, move, archive, and delete are verified for top-level mailbox paths such as INBOX and Archive.move or archive, Mail may assign a new internal numeric id; refresh it with another recent or read before the next mutation.move, archive, delete), identify the exact target messages from recent or search.mailboxPath over mailbox when a folder name could be ambiguous.