{ "schemaVersion": "1.0", "item": { "slug": "homepod", "name": "HomePod", "source": "tencent", "type": "skill", "category": "通讯协作", "sourceUrl": "https://clawhub.ai/ivangdavila/homepod", "canonicalUrl": "https://clawhub.ai/ivangdavila/homepod", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/homepod", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=homepod", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "SKILL.md", "automation-playbook.md", "direct-control.md", "memory-template.md", "network-diagnostics.md", "setup.md" ], "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. 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. 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-23T16:43:11.935Z", "expiresAt": "2026-04-30T16:43:11.935Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=4claw-imageboard", "contentDisposition": "attachment; filename=\"4claw-imageboard-1.0.1.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/homepod" }, "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/homepod", "agentPageUrl": "https://openagent3.xyz/skills/homepod/agent", "manifestUrl": "https://openagent3.xyz/skills/homepod/agent.json", "briefUrl": "https://openagent3.xyz/skills/homepod/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. 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. Summarize what changed and any follow-up checks I should run." } ] }, "documentation": { "source": "clawhub", "primaryDoc": "SKILL.md", "sections": [ { "title": "Setup", "body": "On first use, read setup.md for activation preferences and baseline context." }, { "title": "When to Use", "body": "Use this skill when tasks involve HomePod setup, direct playback control, Siri playback issues, Home app automations, or multiroom audio stability. Prefer this over generic audio advice when Apple Home ecosystem constraints drive the outcome." }, { "title": "Architecture", "body": "Memory lives in ~/homepod/. See memory-template.md for structure.\n\n~/homepod/\n|-- memory.md # Status, activation boundaries, and current setup\n|-- homes.md # Home topology and device mapping\n|-- automation-log.md # Trigger failures, fixes, and validation results\n`-- network-notes.md # Wi-Fi, Thread, and router behavior notes" }, { "title": "Quick Reference", "body": "Use the smallest relevant file for the current incident to keep troubleshooting focused.\n\nTopicFileSetup processsetup.mdMemory templatememory-template.mdDirect connection and controldirect-control.mdNetwork triage flownetwork-diagnostics.mdAutomation reliability playbookautomation-playbook.mdSiri failure recovery mapsiri-recovery.md" }, { "title": "1. Confirm Real Topology Before Advice", "body": "Capture HomePod model, software version, home hub role, and active network layout before suggesting fixes.\nDo not assume Thread, stereo pairs, or eARC are available without explicit confirmation." }, { "title": "2. Separate Network, Device, and Service Failures", "body": "Classify each incident as local network path, HomePod device state, or cloud service dependency.\nApply the narrowest fix first and re-test before moving to broader resets." }, { "title": "3. Keep Automation Debugging Deterministic", "body": "For each failing automation, log trigger, condition, expected action, and actual result in one record.\nTest one change at a time so root cause remains attributable." }, { "title": "4. Validate Multiroom Audio with Repeatable Checks", "body": "Test sync, handoff, and output routing with a fixed sequence across all target rooms.\nTreat intermittent latency as a measurable defect, not user error." }, { "title": "5. Protect User Privacy and Household Boundaries", "body": "Keep notes focused on devices, states, and failures, never on raw voice transcripts or personal content.\nIf account-level actions are needed, explain impact and request explicit confirmation first." }, { "title": "6. Prefer Reversible Fixes Before Factory Reset", "body": "Start with service restart, network path validation, and accessory reassociation before destructive actions.\nReserve full reset workflows for verified dead-end states only." }, { "title": "7. Execute Direct Control in Guarded Mode", "body": "For command execution, require explicit target and intent confirmation before any mutating action.\nUse direct-control.md and run read-only commands first (scan, device_info, playing, volume) before play, pause, stop, or set_volume." }, { "title": "Common Traps", "body": "Treating every Siri error as network related -> repeated failures because account or Home hub state was never checked.\nResetting devices before collecting evidence -> no reproducible signal and slower recovery.\nChanging multiple automation variables at once -> unclear root cause and unstable behavior.\nIgnoring software version drift across devices -> non-deterministic automation and audio routing outcomes.\nTesting only one room in multiroom setups -> latent sync issues missed until production use.\nSending control commands to ambiguous device names -> wrong-room playback changes and user trust loss." }, { "title": "Security & Privacy", "body": "Data that leaves your machine:\n\nNone by default. Direct control uses local network traffic to HomePod or Apple TV devices.\n\nData that stays local:\n\nSetup context and troubleshooting notes in ~/homepod/.\n\nThis skill does NOT:\n\nSend undeclared network requests.\nExecute mutating control commands without target confirmation.\nModify files outside ~/homepod/ for storage.\nModify its own SKILL.md." }, { "title": "Related Skills", "body": "Install with clawhub install if user confirms:\n\nsmart-home - Cross-vendor smart-home architecture and reliability patterns\nsiri - Siri interaction and intent quality troubleshooting\nwifi - Local network diagnostics for latency and packet-loss issues\naudio - Audio routing, quality, and playback reliability workflows\nios - iOS-side Home app and device configuration support" }, { "title": "Feedback", "body": "If useful: clawhub star homepod\nStay updated: clawhub sync" } ], "body": "Setup\n\nOn first use, read setup.md for activation preferences and baseline context.\n\nWhen to Use\n\nUse this skill when tasks involve HomePod setup, direct playback control, Siri playback issues, Home app automations, or multiroom audio stability. Prefer this over generic audio advice when Apple Home ecosystem constraints drive the outcome.\n\nArchitecture\n\nMemory lives in ~/homepod/. See memory-template.md for structure.\n\n~/homepod/\n|-- memory.md # Status, activation boundaries, and current setup\n|-- homes.md # Home topology and device mapping\n|-- automation-log.md # Trigger failures, fixes, and validation results\n`-- network-notes.md # Wi-Fi, Thread, and router behavior notes\n\nQuick Reference\n\nUse the smallest relevant file for the current incident to keep troubleshooting focused.\n\nTopic\tFile\nSetup process\tsetup.md\nMemory template\tmemory-template.md\nDirect connection and control\tdirect-control.md\nNetwork triage flow\tnetwork-diagnostics.md\nAutomation reliability playbook\tautomation-playbook.md\nSiri failure recovery map\tsiri-recovery.md\nCore Rules\n1. Confirm Real Topology Before Advice\nCapture HomePod model, software version, home hub role, and active network layout before suggesting fixes.\nDo not assume Thread, stereo pairs, or eARC are available without explicit confirmation.\n2. Separate Network, Device, and Service Failures\nClassify each incident as local network path, HomePod device state, or cloud service dependency.\nApply the narrowest fix first and re-test before moving to broader resets.\n3. Keep Automation Debugging Deterministic\nFor each failing automation, log trigger, condition, expected action, and actual result in one record.\nTest one change at a time so root cause remains attributable.\n4. Validate Multiroom Audio with Repeatable Checks\nTest sync, handoff, and output routing with a fixed sequence across all target rooms.\nTreat intermittent latency as a measurable defect, not user error.\n5. Protect User Privacy and Household Boundaries\nKeep notes focused on devices, states, and failures, never on raw voice transcripts or personal content.\nIf account-level actions are needed, explain impact and request explicit confirmation first.\n6. Prefer Reversible Fixes Before Factory Reset\nStart with service restart, network path validation, and accessory reassociation before destructive actions.\nReserve full reset workflows for verified dead-end states only.\n7. Execute Direct Control in Guarded Mode\nFor command execution, require explicit target and intent confirmation before any mutating action.\nUse direct-control.md and run read-only commands first (scan, device_info, playing, volume) before play, pause, stop, or set_volume.\nCommon Traps\nTreating every Siri error as network related -> repeated failures because account or Home hub state was never checked.\nResetting devices before collecting evidence -> no reproducible signal and slower recovery.\nChanging multiple automation variables at once -> unclear root cause and unstable behavior.\nIgnoring software version drift across devices -> non-deterministic automation and audio routing outcomes.\nTesting only one room in multiroom setups -> latent sync issues missed until production use.\nSending control commands to ambiguous device names -> wrong-room playback changes and user trust loss.\nSecurity & Privacy\n\nData that leaves your machine:\n\nNone by default. Direct control uses local network traffic to HomePod or Apple TV devices.\n\nData that stays local:\n\nSetup context and troubleshooting notes in ~/homepod/.\n\nThis skill does NOT:\n\nSend undeclared network requests.\nExecute mutating control commands without target confirmation.\nModify files outside ~/homepod/ for storage.\nModify its own SKILL.md.\nRelated Skills\n\nInstall with clawhub install if user confirms:\n\nsmart-home - Cross-vendor smart-home architecture and reliability patterns\nsiri - Siri interaction and intent quality troubleshooting\nwifi - Local network diagnostics for latency and packet-loss issues\naudio - Audio routing, quality, and playback reliability workflows\nios - iOS-side Home app and device configuration support\nFeedback\nIf useful: clawhub star homepod\nStay updated: clawhub sync" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/ivangdavila/homepod", "publisherUrl": "https://clawhub.ai/ivangdavila/homepod", "owner": "ivangdavila", "version": "1.0.0", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/homepod", "downloadUrl": "https://openagent3.xyz/downloads/homepod", "agentUrl": "https://openagent3.xyz/skills/homepod/agent", "manifestUrl": "https://openagent3.xyz/skills/homepod/agent.json", "briefUrl": "https://openagent3.xyz/skills/homepod/agent.md" } }