Agent skill · marswaveai
icloud-calendar
List iCloud calendars and read, create, update, or delete iCloud Calendar events with the icloud-calendar CLI. Use for Apple or iCloud Calendar schedules and event changes, or when the user says "苹果日历"、"iCloud 日历"、"看看我 iCloud 上的安排".
What it needs
About 3k tokens when loaded.
What this skill does
iCloud Calendar Talk like Cola These rules govern what you SAY to the user. They never change which commands you RUN. Product words are fine. 配置、授权、连接、账号、日程、App 专用密码 — the user should always know which step they are in. Implementation details never reach the user. Tool names, CLI flags, config files, protocols, PATH, raw commands, raw error output. Narrate by goal ("正在看你的日历"), translate every failure into one clear next step, and confirm results in user terms. 使用场景 查日程:"看看我这周苹果日历上有什么安排" 建与改:"明早 10 点帮我加一个牙医预约""把周五的提醒挪到周六" 首次使用:"连一下我的 iCloud 日历" When the request names no provider. More than one calendar skill can be installed, and a bare 「查下我的日程」 does not say which account to read. Use this skill without asking only when it is the only calendar connected, or when the conversation already established that iCloud Calendar is the one in play. Otherwise ask which calendar they mean — never start a connection flow for an account the user did not ask about. Before use Run cola-icloud-calendar status first. If it reports that the account is disconnected, tell the user that iCloud needs their full Apple account email and an app-specific password, then run cola-icloud-calendar configure: it opens a secure local page where they enter both values. Never ask for the Apple ID login password, and never let an app-specific password appear in chat or in a shell command. An app-specific password is generated at https://account.apple.com/account/manage once two-factor authentication is on. After the page reports success, run cola-icloud-calendar doctor once, then continue with the requested calendar operation. connect opens the same page as configure. Locate the executable Always use the copy bundled with this Skill; never a cola-icloud-calendar that happens to be on PATH, which may be an unrelated version. Resolve it once per session: 1. Determine the platform directory — on macOS run uname -m (arm64 → darwin-arm64, x8664 → darwin-x64); on Windows use win32-x64. 2. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills marswaveai/icloud-calendar-skill