# Send apple-calendar-pro to your agent
Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.
## Fast path
- Download the package from Yavira.
- Extract it into a folder your agent can access.
- Paste one of the prompts below and point your agent at the extracted folder.
## Suggested prompts
### New install

```text
I downloaded a skill package from Yavira. Read SKILL.md from the extracted folder and install it by following the included instructions. Then review README.md for any prerequisites, environment setup, or post-install checks. Tell me what you changed and call out any manual steps you could not complete.
```
### Upgrade existing

```text
I downloaded an updated skill package from Yavira. Read SKILL.md from the extracted folder, compare it with my current installation, and upgrade it while preserving any custom configuration unless the package docs explicitly say otherwise. Then review README.md for any prerequisites, environment setup, or post-install checks. Summarize what changed and any follow-up checks I should run.
```
## Machine-readable fields
```json
{
  "schemaVersion": "1.0",
  "item": {
    "slug": "apple-calendar-pro",
    "name": "apple-calendar-pro",
    "source": "tencent",
    "type": "skill",
    "category": "效率提升",
    "sourceUrl": "https://clawhub.ai/xushen-ma/apple-calendar-pro",
    "canonicalUrl": "https://clawhub.ai/xushen-ma/apple-calendar-pro",
    "targetPlatform": "OpenClaw"
  },
  "install": {
    "downloadUrl": "/downloads/apple-calendar-pro",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=apple-calendar-pro",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "packageFormat": "ZIP package",
    "primaryDoc": "SKILL.md",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "_meta.json",
      "scripts/applecal.py"
    ],
    "downloadMode": "redirect",
    "sourceHealth": {
      "source": "tencent",
      "status": "healthy",
      "reason": "direct_download_ok",
      "recommendedAction": "download",
      "checkedAt": "2026-04-30T16:55:25.780Z",
      "expiresAt": "2026-05-07T16:55:25.780Z",
      "httpStatus": 200,
      "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
      "contentType": "application/zip",
      "probeMethod": "head",
      "details": {
        "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=network",
        "contentDisposition": "attachment; filename=\"network-1.0.0.zip\"",
        "redirectLocation": null,
        "bodySnippet": null
      },
      "scope": "source",
      "summary": "Source download looks usable.",
      "detail": "Yavira can redirect you to the upstream package for this source.",
      "primaryActionLabel": "Download for OpenClaw",
      "primaryActionHref": "/downloads/apple-calendar-pro"
    },
    "validation": {
      "installChecklist": [
        "Use the Yavira download entry.",
        "Review SKILL.md after the package is downloaded.",
        "Confirm the extracted package contains the expected setup assets."
      ],
      "postInstallChecks": [
        "Confirm the extracted package includes the expected docs or setup files.",
        "Validate the skill or prompts are available in your target agent workspace.",
        "Capture any manual follow-up steps the agent could not complete."
      ]
    }
  },
  "links": {
    "detailUrl": "https://openagent3.xyz/skills/apple-calendar-pro",
    "downloadUrl": "https://openagent3.xyz/downloads/apple-calendar-pro",
    "agentUrl": "https://openagent3.xyz/skills/apple-calendar-pro/agent",
    "manifestUrl": "https://openagent3.xyz/skills/apple-calendar-pro/agent.json",
    "briefUrl": "https://openagent3.xyz/skills/apple-calendar-pro/agent.md"
  }
}
```
## Documentation

### apple-calendar-pro

Advanced Apple Calendar integration using CalDAV (RFC 4791) and Managed Attachments (RFC 8607).

### Primary CLI

scripts/applecal.py

### Capabilities

Event CRUD: List, Create, Update, Delete.
Multi-Calendar Support: Query multiple calendars in a single command.
True Attachments: RFC 8607 compatible (works on iPhone/iPad).
Free/Busy: CalDAV scheduling lookup with event-derived fallback.

### List Events (Combined)

Check multiple calendars at once:

python3 scripts/applecal.py events list \\
  --apple-id your@icloud.com \\
  --calendar Family \\
  --calendar Work \\
  --from "2026-02-26T00:00:00Z" \\
  --to "2026-02-26T23:59:59Z"

### Create All-Day Event

python3 scripts/applecal.py events create \\
  --apple-id your@icloud.com \\
  --calendar Family \\
  --summary "Birthday" \\
  --start "2026-02-26" \\
  --end "2026-02-26" \\
  --all-day

### Attach a File (iPhone Safe)

python3 scripts/applecal.py attach add \\
  --apple-id your@icloud.com \\
  --calendar Family \\
  --uid <UID> \\
  --file /path/to/document.pdf

### Free/Busy Check

python3 scripts/applecal.py freebusy \\
  --apple-id your@icloud.com \\
  --calendar Family \\
  --from "2026-02-26T00:00:00Z" \\
  --to "2026-02-26T23:59:59Z"

### Notes

Birthdays: The virtual "Birthdays" calendar is not searchable via CalDAV. Key birthdays should be added as physical recurring events in the Family calendar for agent visibility.
Auth: Resolution order is APPLECAL_PASSWORD → Python keyring (if installed/configured) → macOS Keychain fallback. Run doctor to verify connectivity.
Event update clearing: Use events update --clear-location / --clear-description to explicitly remove optional fields.
Attachment safety: attach add blocks sensitive paths/names, allowlists file extensions, and supports optional directory scoping via APPLECAL_ATTACH_DIR.
Apple ID: Always pass --apple-id your@icloud.com (the iCloud account email, not necessarily your Apple ID login).
## Trust
- Source: tencent
- Verification: Indexed source record
- Publisher: xushen-ma
- Version: 1.3.0
## Source health
- Status: healthy
- Source download looks usable.
- Yavira can redirect you to the upstream package for this source.
- Health scope: source
- Reason: direct_download_ok
- Checked at: 2026-04-30T16:55:25.780Z
- Expires at: 2026-05-07T16:55:25.780Z
- Recommended action: Download for OpenClaw
## Links
- [Detail page](https://openagent3.xyz/skills/apple-calendar-pro)
- [Send to Agent page](https://openagent3.xyz/skills/apple-calendar-pro/agent)
- [JSON manifest](https://openagent3.xyz/skills/apple-calendar-pro/agent.json)
- [Markdown brief](https://openagent3.xyz/skills/apple-calendar-pro/agent.md)
- [Download page](https://openagent3.xyz/downloads/apple-calendar-pro)