feat(skills): add icloud-tools skill (CalDAV/CardDAV/IMAP/SMTP)

[glifocat]

Type of Change

• Skill - adds a new skill in .claude/skills/
• Fix - bug fix or security fix to source code
• Simplification - reduces or simplifies source code

Description

Adds icloud-tools skill package that gives NanoClaw agents access to iCloud productivity apps via standard protocols (CalDAV, CardDAV, IMAP, SMTP) using an app-specific password.

Tools provided:

• Calendar (6 tools): list calendars, list/create/update/delete events, upcoming
• Contacts (4 tools): search, list groups, create, update
• Mail (12 tools): folders, read, send, reply, forward, drafts, flag, move, search
• Notes (2 tools): list, read (read-only via IMAP)

Key features:

• Works on any platform (no macOS requirement) — uses app-specific passwords
• Module selector (ICLOUD_MODULES env var) for per-group customization
• Optional sender alias support (ICLOUD_SENDER_EMAIL)

For Skills

• I have not made any changes to source code
• My skill contains instructions for Claude to follow (not pre-built code)
• I tested this skill on a fresh clone

🤖 Generated with Claude Code

[TomGranot]

iCloud tools skill (CalDAV/CardDAV/IMAP/SMTP) — that's ambitious. @gavrielc let's take a look at the scope here and make sure it's maintainable.

[glifocat]

Updated to v1.1.0 with bug fixes and improvements discovered during e2e testing:

Bug fixes:

• Mail: handleReadMessage now marks messages as \Seen (read) after fetch
• Mail: handleSend, handleReply, handleForward now save a copy to "Sent Messages" via IMAP APPEND
• Contacts: rebuildVCard was missing the N: (structured name) field required by iCloud CardDAV — updates were silently rejected

New feature:

• Mail: markdown-to-HTML rendering — all outgoing emails (send, reply, forward, drafts) now include both text/plain and text/html parts using marked

e2e validated against a real iCloud account — calendar, contacts, mail, and notes all passing.