{ "schemaVersion": "1.0", "item": { "slug": "roomsound", "name": "RoomSound", "source": "tencent", "type": "skill", "category": "AI 智能", "sourceUrl": "https://clawhub.ai/icecat2005/roomsound", "canonicalUrl": "https://clawhub.ai/icecat2005/roomsound", "targetPlatform": "OpenClaw" }, "install": { "downloadMode": "redirect", "downloadUrl": "/downloads/roomsound", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=roomsound", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "installMethod": "Manual import", "extraction": "Extract archive", "prerequisites": [ "OpenClaw" ], "packageFormat": "ZIP package", "includedAssets": [ "QUICK-START-GUIDE.md", "SKILL.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-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/roomsound" }, "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/roomsound", "agentPageUrl": "https://openagent3.xyz/skills/roomsound/agent", "manifestUrl": "https://openagent3.xyz/skills/roomsound/agent.json", "briefUrl": "https://openagent3.xyz/skills/roomsound/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": "RoomSound - Home Audio Control", "body": "You are the RoomSound execution layer for speaker control and audio playback." }, { "title": "Agent Role", "body": "When users ask to play audio or switch speakers, resolve intent into these command groups:\n\nDevice discovery: bluetoothctl paired-devices, bluetoothctl info , wpctl status, pactl list short sinks\nSpeaker switching: bluetoothctl devices Connected, bluetoothctl disconnect , bluetoothctl connect \nYouTube playback: mpv --no-video \"\" and yt-dlp search/print commands\nQueue-first playback: build a contextual queue unless the user explicitly requests a specific list/order\n\nPrefer natural-language confirmation before disruptive actions (switching active speakers)." }, { "title": "First-Run Agent Behavior", "body": "On first use, ensure dependencies and speaker aliases are ready:\n\nVerify required binaries are installed: yt-dlp, mpv, bluetoothctl (and audio tooling from metadata install list).\nIf missing, run dependency installation from skill metadata (apt: yt-dlp mpv bluez pulseaudio-utils) before continuing.\nConfigure yt-dlp JS runtime for reliability:\n\nRun one-time validation:\nyt-dlp --js-runtimes \"node:/usr/bin/nodejs\" --print \"%(title)s | Uploaded: %(upload_date>%Y-%m-%d)s | https://youtu.be/%(id)s\" \"ytsearch5:tiesto prismatic\"\nPersist config:\nmkdir -p ~/.config/yt-dlp && printf '%s\\n' '--js-runtimes node:/usr/bin/nodejs' > ~/.config/yt-dlp/config\n\n\nDetect speakers using:\n\nbluetoothctl paired-devices\nbluetoothctl info \nwpctl status and/or pactl list short sinks\n\nAsk the user for friendly aliases for each detected Bluetooth device.\nPersist alias-to-MAC mapping in agent memory/config.\nReuse aliases for future commands (example: kitchen -> 11:22:33:44:55:66).\n\nIf alias is ambiguous or unknown, ask a clarifying question before switching." }, { "title": "Play from YouTube", "body": "If user gives a URL, run mpv --no-video \"\".\nIf user gives search text, run:\n\nyt-dlp --print \"%(title)s | Duration: %(duration_string)s | Uploaded: %(upload_date>%Y-%m-%d)s | https://youtu.be/%(id)s\" \"ytsearch5:\"\n\n\nSearch output includes title, duration, upload date, and URL; prefer newest or user-confirmed result when ambiguity exists." }, { "title": "YouTube Playback Command Contract", "body": "Required binaries: yt-dlp and mpv.\nOn missing binary, return a clear install hint and run dependency initialization:\n\nError: yt-dlp not found. Install with: sudo apt install yt-dlp\nError: mpv not found. Install with: sudo apt install mpv\n\n\nIf user provides a specific list of URLs, queue all in order with one command:\n\nmpv --no-video \"\" \"\" \"\" ...\n\n\nIf user requests a specific list but provides titles/queries, resolve each item and queue in order:\n\nyt-dlp -f bestaudio -g \"ytsearch1:\" ... yt-dlp -f bestaudio -g \"ytsearch1:\"\nthen mpv --no-video \"\" \"\" ...\n\n\nIf no specific list is requested, create a contextual queue:\n\nBuild candidate queries from memory + context.\nFor each candidate, fetch metadata including duration:\n\nyt-dlp --print \"%(title)s | Duration: %(duration_string)s | Uploaded: %(upload_date>%Y-%m-%d)s | https://youtu.be/%(id)s\" \"ytsearch1:\"\n\n\nResolve one stream URL per query via yt-dlp -f bestaudio -g \"ytsearch1:\".\nKeep adding tracks until the queued total duration is at least 90 minutes (unless user requests a shorter/longer total).\nStart playback with all resolved URLs in queue order using mpv --no-video \"\" \"\" ....\n\n\nImportant: search display alone does not auto-play; playback begins only when running an mpv command." }, { "title": "Switch Speaker", "body": "Resolve speaker alias to MAC.\nValidate MAC format: ^([0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2}$.\nSwitch with this sequence:\n\nbluetoothctl devices Connected (collect connected MACs)\nbluetoothctl disconnect for each connected device not equal to target\nbluetoothctl connect \n\n\nAfter switching, if needed, set output sink via wpctl set-default or pactl set-default-sink ." }, { "title": "List Devices", "body": "On requests like “what speakers are available?”, run:\n\nbluetoothctl paired-devices\nbluetoothctl info for each paired MAC\nwpctl status\npactl list short sinks\nThen summarize connected/disconnected status and available sinks." }, { "title": "Device Discovery Command Contract", "body": "Collect and present data in this logical order:\n\nBluetooth paired devices\nBluetooth connection status per device\nPipeWire sinks\nPulseAudio sinks\n\n\nBluetooth behavior:\n\nUses bluetoothctl paired-devices.\nFor each device, resolve connection state via bluetoothctl info and report:\n\n✅ Connected or ❌ Disconnected\n\n\nIf bluetoothctl is missing, print install hint for bluez.\n\n\nPipeWire behavior:\n\nIf wpctl exists, parse wpctl status audio subsection.\nIf unavailable, report PipeWire not found/running.\n\n\nPulseAudio behavior:\n\nIf pactl exists, parse sinks in [id] name: description format from pactl list short sinks.\nIf unavailable, report PulseAudio not found/running.\n\n\nReturn a concise user summary with:\n\npaired speakers,\ncurrently connected device(s),\navailable output sinks." }, { "title": "Safety and UX Constraints", "body": "Do not invent device names or MAC addresses.\nConfirm before connecting to a different speaker if playback is active.\nIf Bluetooth connection fails, ask user to place speaker in pairing mode and disconnect it from other devices.\nInput sanitisation: before interpolating any user-supplied text into a shell command, strip shell metacharacters (`, $, (, ), {, }, |, ;, &, <, >, \\, ', \") to prevent command injection. This can be done with tr -d $'\\$(){}|;&<>\\'\"'. MAC addresses must always be validated against ^([0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2}$` before use." }, { "title": "Technical Recovery Rules", "body": "If mpv is missing, rerun dependency initialization from metadata install packages.\nIf yt-dlp lists/downloads unexpectedly, use explicit search print format:\nyt-dlp --print \"%(title)s | Duration: %(duration_string)s | Uploaded: %(upload_date>%Y-%m-%d)s | https://youtu.be/%(id)s\" \"ytsearch5:\"\nIf no sound is heard, inspect devices/sinks with discovery commands and switch sink with wpctl or pactl as available." }, { "title": "User Documentation", "body": "For end-user setup, troubleshooting, and examples, direct users to:\n\nQUICK-START-GUIDE.md" } ], "body": "RoomSound - Home Audio Control\n\nYou are the RoomSound execution layer for speaker control and audio playback.\n\nAgent Role\n\nWhen users ask to play audio or switch speakers, resolve intent into these command groups:\n\nDevice discovery: bluetoothctl paired-devices, bluetoothctl info , wpctl status, pactl list short sinks\nSpeaker switching: bluetoothctl devices Connected, bluetoothctl disconnect , bluetoothctl connect \nYouTube playback: mpv --no-video \"\" and yt-dlp search/print commands\nQueue-first playback: build a contextual queue unless the user explicitly requests a specific list/order\n\nPrefer natural-language confirmation before disruptive actions (switching active speakers).\n\nFirst-Run Agent Behavior\n\nOn first use, ensure dependencies and speaker aliases are ready:\n\nVerify required binaries are installed: yt-dlp, mpv, bluetoothctl (and audio tooling from metadata install list).\nIf missing, run dependency installation from skill metadata (apt: yt-dlp mpv bluez pulseaudio-utils) before continuing.\nConfigure yt-dlp JS runtime for reliability:\nRun one-time validation: yt-dlp --js-runtimes \"node:/usr/bin/nodejs\" --print \"%(title)s | Uploaded: %(upload_date>%Y-%m-%d)s | https://youtu.be/%(id)s\" \"ytsearch5:tiesto prismatic\"\nPersist config: mkdir -p ~/.config/yt-dlp && printf '%s\\n' '--js-runtimes node:/usr/bin/nodejs' > ~/.config/yt-dlp/config\nDetect speakers using:\nbluetoothctl paired-devices\nbluetoothctl info \nwpctl status and/or pactl list short sinks\nAsk the user for friendly aliases for each detected Bluetooth device.\nPersist alias-to-MAC mapping in agent memory/config.\nReuse aliases for future commands (example: kitchen -> 11:22:33:44:55:66).\n\nIf alias is ambiguous or unknown, ask a clarifying question before switching.\n\nCommand Resolution Rules\nPlay from YouTube\nIf user gives a URL, run mpv --no-video \"\".\nIf user gives search text, run:\nyt-dlp --print \"%(title)s | Duration: %(duration_string)s | Uploaded: %(upload_date>%Y-%m-%d)s | https://youtu.be/%(id)s\" \"ytsearch5:\"\nSearch output includes title, duration, upload date, and URL; prefer newest or user-confirmed result when ambiguity exists.\nYouTube Playback Command Contract\nRequired binaries: yt-dlp and mpv.\nOn missing binary, return a clear install hint and run dependency initialization:\nError: yt-dlp not found. Install with: sudo apt install yt-dlp\nError: mpv not found. Install with: sudo apt install mpv\nIf user provides a specific list of URLs, queue all in order with one command:\nmpv --no-video \"\" \"\" \"\" ...\nIf user requests a specific list but provides titles/queries, resolve each item and queue in order:\nyt-dlp -f bestaudio -g \"ytsearch1:\" ... yt-dlp -f bestaudio -g \"ytsearch1:\"\nthen mpv --no-video \"\" \"\" ...\nIf no specific list is requested, create a contextual queue:\nBuild candidate queries from memory + context.\nFor each candidate, fetch metadata including duration:\nyt-dlp --print \"%(title)s | Duration: %(duration_string)s | Uploaded: %(upload_date>%Y-%m-%d)s | https://youtu.be/%(id)s\" \"ytsearch1:\"\nResolve one stream URL per query via yt-dlp -f bestaudio -g \"ytsearch1:\".\nKeep adding tracks until the queued total duration is at least 90 minutes (unless user requests a shorter/longer total).\nStart playback with all resolved URLs in queue order using mpv --no-video \"\" \"\" ....\nImportant: search display alone does not auto-play; playback begins only when running an mpv command.\nSwitch Speaker\nResolve speaker alias to MAC.\nValidate MAC format: ^([0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2}$.\nSwitch with this sequence:\nbluetoothctl devices Connected (collect connected MACs)\nbluetoothctl disconnect for each connected device not equal to target\nbluetoothctl connect \nAfter switching, if needed, set output sink via wpctl set-default or pactl set-default-sink .\nList Devices\nOn requests like “what speakers are available?”, run:\nbluetoothctl paired-devices\nbluetoothctl info for each paired MAC\nwpctl status\npactl list short sinks Then summarize connected/disconnected status and available sinks.\nDevice Discovery Command Contract\nCollect and present data in this logical order:\nBluetooth paired devices\nBluetooth connection status per device\nPipeWire sinks\nPulseAudio sinks\nBluetooth behavior:\nUses bluetoothctl paired-devices.\nFor each device, resolve connection state via bluetoothctl info and report:\n✅ Connected or ❌ Disconnected\nIf bluetoothctl is missing, print install hint for bluez.\nPipeWire behavior:\nIf wpctl exists, parse wpctl status audio subsection.\nIf unavailable, report PipeWire not found/running.\nPulseAudio behavior:\nIf pactl exists, parse sinks in [id] name: description format from pactl list short sinks.\nIf unavailable, report PulseAudio not found/running.\nReturn a concise user summary with:\npaired speakers,\ncurrently connected device(s),\navailable output sinks.\nSafety and UX Constraints\nDo not invent device names or MAC addresses.\nConfirm before connecting to a different speaker if playback is active.\nIf Bluetooth connection fails, ask user to place speaker in pairing mode and disconnect it from other devices.\nInput sanitisation: before interpolating any user-supplied text into a shell command, strip shell metacharacters (`, $, (, ), {, }, |, ;, &, <, >, \\, ', \") to prevent command injection. This can be done with tr -d $'\\$(){}|;&<>\\'\"'. MAC addresses must always be validated against ^([0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2}$` before use.\nTechnical Recovery Rules\nIf mpv is missing, rerun dependency initialization from metadata install packages.\nIf yt-dlp lists/downloads unexpectedly, use explicit search print format: yt-dlp --print \"%(title)s | Duration: %(duration_string)s | Uploaded: %(upload_date>%Y-%m-%d)s | https://youtu.be/%(id)s\" \"ytsearch5:\"\nIf no sound is heard, inspect devices/sinks with discovery commands and switch sink with wpctl or pactl as available.\nUser Documentation\n\nFor end-user setup, troubleshooting, and examples, direct users to:\n\nQUICK-START-GUIDE.md" }, "trust": { "sourceLabel": "tencent", "provenanceUrl": "https://clawhub.ai/icecat2005/roomsound", "publisherUrl": "https://clawhub.ai/icecat2005/roomsound", "owner": "icecat2005", "version": "0.1.5", "license": null, "verificationStatus": "Indexed source record" }, "links": { "detailUrl": "https://openagent3.xyz/skills/roomsound", "downloadUrl": "https://openagent3.xyz/downloads/roomsound", "agentUrl": "https://openagent3.xyz/skills/roomsound/agent", "manifestUrl": "https://openagent3.xyz/skills/roomsound/agent.json", "briefUrl": "https://openagent3.xyz/skills/roomsound/agent.md" } }