# Send RoomSound 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. 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. Summarize what changed and any follow-up checks I should run. ``` ## Machine-readable fields ```json { "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": { "downloadUrl": "/downloads/roomsound", "sourceDownloadUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=roomsound", "sourcePlatform": "tencent", "targetPlatform": "OpenClaw", "packageFormat": "ZIP package", "primaryDoc": "SKILL.md", "includedAssets": [ "QUICK-START-GUIDE.md", "SKILL.md" ], "downloadMode": "redirect", "sourceHealth": { "source": "tencent", "slug": "roomsound", "status": "healthy", "reason": "direct_download_ok", "recommendedAction": "download", "checkedAt": "2026-05-03T11:49:01.727Z", "expiresAt": "2026-05-10T11:49:01.727Z", "httpStatus": 200, "finalUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=roomsound", "contentType": "application/zip", "probeMethod": "head", "details": { "probeUrl": "https://wry-manatee-359.convex.site/api/v1/download?slug=roomsound", "contentDisposition": "attachment; filename=\"roomsound-0.1.5.zip\"", "redirectLocation": null, "bodySnippet": null, "slug": "roomsound" }, "scope": "item", "summary": "Item download looks usable.", "detail": "Yavira can redirect you to the upstream package for this item.", "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." ] } }, "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" } } ``` ## Documentation ### RoomSound - Home Audio Control You are the RoomSound execution layer for speaker control and audio playback. ### Agent Role When users ask to play audio or switch speakers, resolve intent into these command groups: Device discovery: bluetoothctl paired-devices, bluetoothctl info , wpctl status, pactl list short sinks Speaker switching: bluetoothctl devices Connected, bluetoothctl disconnect , bluetoothctl connect YouTube playback: mpv --no-video "" and yt-dlp search/print commands Queue-first playback: build a contextual queue unless the user explicitly requests a specific list/order Prefer natural-language confirmation before disruptive actions (switching active speakers). ### First-Run Agent Behavior On first use, ensure dependencies and speaker aliases are ready: Verify required binaries are installed: yt-dlp, mpv, bluetoothctl (and audio tooling from metadata install list). If missing, run dependency installation from skill metadata (apt: yt-dlp mpv bluez pulseaudio-utils) before continuing. Configure yt-dlp JS runtime for reliability: Run 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" Persist config: mkdir -p ~/.config/yt-dlp && printf '%s\\n' '--js-runtimes node:/usr/bin/nodejs' > ~/.config/yt-dlp/config Detect speakers using: bluetoothctl paired-devices bluetoothctl info wpctl status and/or pactl list short sinks Ask the user for friendly aliases for each detected Bluetooth device. Persist alias-to-MAC mapping in agent memory/config. Reuse aliases for future commands (example: kitchen -> 11:22:33:44:55:66). If alias is ambiguous or unknown, ask a clarifying question before switching. ### Play from YouTube If user gives a URL, run mpv --no-video "". If user gives search text, run: yt-dlp --print "%(title)s | Duration: %(duration_string)s | Uploaded: %(upload_date>%Y-%m-%d)s | https://youtu.be/%(id)s" "ytsearch5:" Search output includes title, duration, upload date, and URL; prefer newest or user-confirmed result when ambiguity exists. ### YouTube Playback Command Contract Required binaries: yt-dlp and mpv. On missing binary, return a clear install hint and run dependency initialization: Error: yt-dlp not found. Install with: sudo apt install yt-dlp Error: mpv not found. Install with: sudo apt install mpv If user provides a specific list of URLs, queue all in order with one command: mpv --no-video "" "" "" ... If user requests a specific list but provides titles/queries, resolve each item and queue in order: yt-dlp -f bestaudio -g "ytsearch1:" ... yt-dlp -f bestaudio -g "ytsearch1:" then mpv --no-video "" "" ... If no specific list is requested, create a contextual queue: Build candidate queries from memory + context. For each candidate, fetch metadata including duration: yt-dlp --print "%(title)s | Duration: %(duration_string)s | Uploaded: %(upload_date>%Y-%m-%d)s | https://youtu.be/%(id)s" "ytsearch1:" Resolve one stream URL per query via yt-dlp -f bestaudio -g "ytsearch1:". Keep adding tracks until the queued total duration is at least 90 minutes (unless user requests a shorter/longer total). Start playback with all resolved URLs in queue order using mpv --no-video "" "" .... Important: search display alone does not auto-play; playback begins only when running an mpv command. ### Switch Speaker Resolve speaker alias to MAC. Validate MAC format: ^([0-9A-Fa-f]{2}:){5}[0-9A-Fa-f]{2}$. Switch with this sequence: bluetoothctl devices Connected (collect connected MACs) bluetoothctl disconnect for each connected device not equal to target bluetoothctl connect After switching, if needed, set output sink via wpctl set-default or pactl set-default-sink . ### List Devices On requests like “what speakers are available?”, run: bluetoothctl paired-devices bluetoothctl info for each paired MAC wpctl status pactl list short sinks Then summarize connected/disconnected status and available sinks. ### Device Discovery Command Contract Collect and present data in this logical order: Bluetooth paired devices Bluetooth connection status per device PipeWire sinks PulseAudio sinks Bluetooth behavior: Uses bluetoothctl paired-devices. For each device, resolve connection state via bluetoothctl info and report: ✅ Connected or ❌ Disconnected If bluetoothctl is missing, print install hint for bluez. PipeWire behavior: If wpctl exists, parse wpctl status audio subsection. If unavailable, report PipeWire not found/running. PulseAudio behavior: If pactl exists, parse sinks in [id] name: description format from pactl list short sinks. If unavailable, report PulseAudio not found/running. Return a concise user summary with: paired speakers, currently connected device(s), available output sinks. ### Safety and UX Constraints Do not invent device names or MAC addresses. Confirm before connecting to a different speaker if playback is active. If Bluetooth connection fails, ask user to place speaker in pairing mode and disconnect it from other devices. Input 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. ### Technical Recovery Rules If mpv is missing, rerun dependency initialization from metadata install packages. If 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:" If no sound is heard, inspect devices/sinks with discovery commands and switch sink with wpctl or pactl as available. ### User Documentation For end-user setup, troubleshooting, and examples, direct users to: QUICK-START-GUIDE.md ## Trust - Source: tencent - Verification: Indexed source record - Publisher: icecat2005 - Version: 0.1.5 ## Source health - Status: healthy - Item download looks usable. - Yavira can redirect you to the upstream package for this item. - Health scope: item - Reason: direct_download_ok - Checked at: 2026-05-03T11:49:01.727Z - Expires at: 2026-05-10T11:49:01.727Z - Recommended action: Download for OpenClaw ## Links - [Detail page](https://openagent3.xyz/skills/roomsound) - [Send to Agent page](https://openagent3.xyz/skills/roomsound/agent) - [JSON manifest](https://openagent3.xyz/skills/roomsound/agent.json) - [Markdown brief](https://openagent3.xyz/skills/roomsound/agent.md) - [Download page](https://openagent3.xyz/downloads/roomsound)