{
  "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": {
    "downloadMode": "redirect",
    "downloadUrl": "/downloads/apple-calendar-pro",
    "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=apple-calendar-pro",
    "sourcePlatform": "tencent",
    "targetPlatform": "OpenClaw",
    "installMethod": "Manual import",
    "extraction": "Extract archive",
    "prerequisites": [
      "OpenClaw"
    ],
    "packageFormat": "ZIP package",
    "includedAssets": [
      "README.md",
      "SKILL.md",
      "_meta.json",
      "scripts/applecal.py"
    ],
    "primaryDoc": "SKILL.md",
    "quickSetup": [
      "Download the package from Yavira.",
      "Extract the archive and review SKILL.md first.",
      "Import or place the package into your OpenClaw setup."
    ],
    "agentAssist": {
      "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
      "steps": [
        "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."
      ],
      "prompts": [
        {
          "label": "New install",
          "body": "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."
        },
        {
          "label": "Upgrade existing",
          "body": "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."
        }
      ]
    },
    "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."
      ]
    },
    "downloadPageUrl": "https://openagent3.xyz/downloads/apple-calendar-pro",
    "agentPageUrl": "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"
  },
  "agentAssist": {
    "summary": "Hand the extracted package to your coding agent with a concrete install brief instead of figuring it out manually.",
    "steps": [
      "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."
    ],
    "prompts": [
      {
        "label": "New install",
        "body": "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."
      },
      {
        "label": "Upgrade existing",
        "body": "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."
      }
    ]
  },
  "documentation": {
    "source": "clawhub",
    "primaryDoc": "SKILL.md",
    "sections": [
      {
        "title": "apple-calendar-pro",
        "body": "Advanced Apple Calendar integration using CalDAV (RFC 4791) and Managed Attachments (RFC 8607)."
      },
      {
        "title": "Primary CLI",
        "body": "scripts/applecal.py"
      },
      {
        "title": "Capabilities",
        "body": "Event CRUD: List, Create, Update, Delete.\nMulti-Calendar Support: Query multiple calendars in a single command.\nTrue Attachments: RFC 8607 compatible (works on iPhone/iPad).\nFree/Busy: CalDAV scheduling lookup with event-derived fallback."
      },
      {
        "title": "List Events (Combined)",
        "body": "Check multiple calendars at once:\n\npython3 scripts/applecal.py events list \\\n  --apple-id your@icloud.com \\\n  --calendar Family \\\n  --calendar Work \\\n  --from \"2026-02-26T00:00:00Z\" \\\n  --to \"2026-02-26T23:59:59Z\""
      },
      {
        "title": "Create All-Day Event",
        "body": "python3 scripts/applecal.py events create \\\n  --apple-id your@icloud.com \\\n  --calendar Family \\\n  --summary \"Birthday\" \\\n  --start \"2026-02-26\" \\\n  --end \"2026-02-26\" \\\n  --all-day"
      },
      {
        "title": "Attach a File (iPhone Safe)",
        "body": "python3 scripts/applecal.py attach add \\\n  --apple-id your@icloud.com \\\n  --calendar Family \\\n  --uid <UID> \\\n  --file /path/to/document.pdf"
      },
      {
        "title": "Free/Busy Check",
        "body": "python3 scripts/applecal.py freebusy \\\n  --apple-id your@icloud.com \\\n  --calendar Family \\\n  --from \"2026-02-26T00:00:00Z\" \\\n  --to \"2026-02-26T23:59:59Z\""
      },
      {
        "title": "Notes",
        "body": "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.\nAuth: Resolution order is APPLECAL_PASSWORD → Python keyring (if installed/configured) → macOS Keychain fallback. Run doctor to verify connectivity.\nEvent update clearing: Use events update --clear-location / --clear-description to explicitly remove optional fields.\nAttachment safety: attach add blocks sensitive paths/names, allowlists file extensions, and supports optional directory scoping via APPLECAL_ATTACH_DIR.\nApple ID: Always pass --apple-id your@icloud.com (the iCloud account email, not necessarily your Apple ID login)."
      }
    ],
    "body": "apple-calendar-pro\n\nAdvanced Apple Calendar integration using CalDAV (RFC 4791) and Managed Attachments (RFC 8607).\n\nPrimary CLI\n\nscripts/applecal.py\n\nCapabilities\nEvent CRUD: List, Create, Update, Delete.\nMulti-Calendar Support: Query multiple calendars in a single command.\nTrue Attachments: RFC 8607 compatible (works on iPhone/iPad).\nFree/Busy: CalDAV scheduling lookup with event-derived fallback.\nCommon Commands\nList Events (Combined)\n\nCheck multiple calendars at once:\n\npython3 scripts/applecal.py events list \\\n  --apple-id your@icloud.com \\\n  --calendar Family \\\n  --calendar Work \\\n  --from \"2026-02-26T00:00:00Z\" \\\n  --to \"2026-02-26T23:59:59Z\"\n\nCreate All-Day Event\npython3 scripts/applecal.py events create \\\n  --apple-id your@icloud.com \\\n  --calendar Family \\\n  --summary \"Birthday\" \\\n  --start \"2026-02-26\" \\\n  --end \"2026-02-26\" \\\n  --all-day\n\nAttach a File (iPhone Safe)\npython3 scripts/applecal.py attach add \\\n  --apple-id your@icloud.com \\\n  --calendar Family \\\n  --uid <UID> \\\n  --file /path/to/document.pdf\n\nFree/Busy Check\npython3 scripts/applecal.py freebusy \\\n  --apple-id your@icloud.com \\\n  --calendar Family \\\n  --from \"2026-02-26T00:00:00Z\" \\\n  --to \"2026-02-26T23:59:59Z\"\n\nNotes\nBirthdays: 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.\nAuth: Resolution order is APPLECAL_PASSWORD → Python keyring (if installed/configured) → macOS Keychain fallback. Run doctor to verify connectivity.\nEvent update clearing: Use events update --clear-location / --clear-description to explicitly remove optional fields.\nAttachment safety: attach add blocks sensitive paths/names, allowlists file extensions, and supports optional directory scoping via APPLECAL_ATTACH_DIR.\nApple ID: Always pass --apple-id your@icloud.com (the iCloud account email, not necessarily your Apple ID login)."
  },
  "trust": {
    "sourceLabel": "tencent",
    "provenanceUrl": "https://clawhub.ai/xushen-ma/apple-calendar-pro",
    "publisherUrl": "https://clawhub.ai/xushen-ma/apple-calendar-pro",
    "owner": "xushen-ma",
    "version": "1.3.0",
    "license": null,
    "verificationStatus": "Indexed source record"
  },
  "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"
  }
}