Agent skill

Sonos

by steipete in steipete/agent-scripts

Sonos control: search, queue, playlists, rooms/groups, volume, YouTube.

MITAuto-check passed

Install Sonos

skills CLI
$ npx skills add steipete/agent-scripts --skill sonos -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install steipete/agent-scripts sonos --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/steipete/agent-scripts.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/sonos .claude/skills/sonos && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
sonos
GitHub stars
7.3k
Token cost
~440 tokens
SKILL.md length
220 words
Files
2
Skills in repo
45
Repo updated
First seen
Licence
MIT

At a glance

Sonos control: search, queue, playlists, rooms/groups, volume, YouTube.

  • Works in 5 steps: Discover repo commands → Identify target → Dry-read current state when useful → …
  • SKILL.md covers Rules, Workflow, Common Tasks and YouTube Notes
  • Calls rg

What it does

Sonos is an agent skill from steipete/agent-scripts. Sonos control: search, queue, playlists, rooms/groups, volume, YouTube.

Its SKILL.md is about 440 tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `agents/openai.yaml`).

It works with YouTube. The repository describes itself as: Scripts for agents, shared between my repositories. The licence is MIT.

Example prompts

  • “Use the sonos skill to sono control: search, queue, playlists, rooms/groups, volume, YouTube”
  • “/sonos”

Workflow steps

5 steps, taken from the first numbered list in SKILL.md.

  1. Discover repo commands
  2. Identify target
  3. Dry-read current state when useful
  4. Execute the requested playback action.
  5. Verify by reading current state again.

What it can do on your machine

Read from SKILL.md and the folder at commit 79150cf. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Shell commands in SKILL.md call:

    • rg

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Sonos loads about 440 tokens when it runs. Until then it costs about 19 tokens; SKILL.md has 220 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~19
When it runs · the whole SKILL.md, loaded when a task matches
~440

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from steipete/agent-scripts at commit 79150cf, republished under its MIT licence (© steipete). 220 words, ~440 tokens.

Download SKILL.mdSave it as .claude/skills/sonos/SKILL.md (or your agent's skills folder). This skill also uses 1 other file; get the full folder from GitHub.
name
sonos
description
Sonos control: search, queue, playlists, rooms/groups, volume, YouTube.
metadata.short-description
Sonos music and YouTube playback

Sonos

Use for Sonos music, playback, queue, room/group, and YouTube workflows.

Rules

  • Prefer existing local Sonos tooling in the current repo before inventing shell/API calls.
  • Do not change speaker groups, queues, or playback unless the user asks for it.
  • Confirm target room/group when ambiguous.
  • For YouTube, prefer a playable audio URL or local extraction workflow already present in the repo; avoid downloading unless requested.
  • Keep network/debug work out of scope unless the user explicitly asks for diagnostics.
  • Secrets, service tokens, and account auth: check env/profile first; use op only via the repo/AGENTS rules.

Workflow

  1. Discover repo commands:
    • rg --files
    • package scripts or CLI help
  2. Identify target:
    • room/group
    • service/source
    • query, URL, playlist, album, artist, or track
  3. Dry-read current state when useful:
    • rooms/groups
    • now playing
    • queue
  4. Execute the requested playback action.
  5. Verify by reading current state again.

Common Tasks

  • Search and play music by track, album, artist, playlist, or station.
  • Add or replace the queue.
  • Pause, resume, skip, seek, shuffle, repeat.
  • Set volume or mute for a room/group.
  • Move/group playback between rooms.
  • Play YouTube audio/music through Sonos when supported by local tooling.

YouTube Notes

  • Treat YouTube URLs as media sources first, not as download requests.
  • If conversion/extraction is needed, prefer the local toolchain already used by the repo.
  • State constraints clearly when Sonos/service support blocks direct playback.

© steipete, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 1 other file in skills/sonos of steipete/agent-scripts.

  • SKILL.md
  • agents/openai.yaml

Open the folder on GitHubat commit 79150cf

Compare with similar skills

Sonos next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Sonos compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Sonos this skillsteipete/agent-scripts7.3k—~440Automated safety check: PassMIT
MarkitdownImCa0/just-laws78214 repos~3.2kAutomated safety check: NotesMIT
Banner Design Systemnextlevelbuilder/ui-ux-pro-max-skill134k1 repos~1.8kAutomated safety check: PassMIT
Agent ReachPanniantong/Agent-Reach94k—~1.4kAutomated safety check: PassMIT
Last30daysmvanhorn/last30days-skill64k—~7.9kAutomated safety check: NotesMIT
Baoyu URL To Markdownsdyckjq-lab/llm-wiki-skill2.5k2 repos~3.2kAutomated safety check: PassNone

Similar skills

  • Markitdown

    ImCa0/just-laws

    Convert files and office documents to Markdown. An agent skill from ImCa0/just-laws.

    782 GitHub starsUsed in 14 repos~3.2k tokens
    Documents & OfficeAuto-check: notes
  • Banner Design System

    nextlevelbuilder/ui-ux-pro-max-skill

    Walks through designing a banner for social media, ads, a website hero or print, from gathering requirements to building 2 or 3 art-direction options in HTML and CSS.

    134k GitHub starsUsed in 1 repo~1.8k tokens
    Frontend & DesignAuto-check passed
  • Agent Reach

    Panniantong/Agent-Reach

    Routes web research and platform lookups across 16 sites, including Twitter, Reddit, YouTube, Bilibili, Xiaohongshu and GitHub, through one command-line tool.

    94k GitHub stars~1.4k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Last30days

    mvanhorn/last30days-skill

    Research what people actually say about any topic in the last 30 days.

    64k GitHub stars~7.9k tokensUpdated today
    Research & ScienceAuto-check: notes
  • Baoyu URL To Markdown

    sdyckjq-lab/llm-wiki-skill

    Fetch any URL and convert to markdown using Chrome CDP. An agent skill from sdyckjq-lab/llm-wiki-skill.

    2.5k GitHub starsUsed in 2 repos~3.2k tokens
    Knowledge ManagementAuto-check passed
  • Google SEO APIs

    AgriciDaniel/claude-seo

    Pulls real Google data for SEO work: Search Console, PageSpeed Insights, CrUX field data, the Indexing API and GA4 organic traffic, through /seo google commands.

    19k GitHub starsUsed in 1 repo~4.2k tokens
    Marketing & SEOAuto-check passed

More from steipete/agent-scripts

All 45 skills in this repo
  • Mac Fleet Maintenance

    steipete/agent-scripts

    Inventories and maintains a fleet of Macs from a desired-state file: package updates, repo and Xcode sync, and disk, backup and security health reports.

    7.3k GitHub stars~4.8k tokensUpdated 4 days ago
    Auto-check passed
  • Agent Transcript for PRs

    steipete/agent-scripts

    Finds a coding agent's session log, trims and redacts it, and inserts it into a GitHub PR or issue only when the user has asked for a transcript.

    7.3k GitHub starsUsed in 1 repo~698 tokens
    Auto-check passed
  • Parallels macOS VM Lab

    steipete/agent-scripts

    Uses a clean Parallels macOS VM to test GUI automation, TCC permission prompts and screenshot tools like Peekaboo, verifying results from outside the guest.

    7.3k GitHub stars~1.8k tokensUpdated 4 days ago
    Auto-check passed
  • ClawSweeper Status

    steipete/agent-scripts

    Reports ClawSweeper's status with a bundled script: workflow health, active workers, queue health and recently merged, reviewed, commented and closed items.

    7.3k GitHub stars~972 tokensUpdated 4 days ago
    Auto-check passed
  • GitHub Project Triage

    steipete/agent-scripts

    Produces maintainer-facing triage cards for a project's GitHub issues and pull requests, each with its URL, risk, test state, blockers and a next action.

    7.3k GitHub stars~4k tokensUpdated 4 days ago
    Auto-check passed
  • Nano Banana Image Generation

    steipete/agent-scripts

    Generates and edits images with Google's Nano Banana 2 (Gemini 3.1 Flash Image) through a uv script, with a draft-then-final workflow and sizes from 512 to 4K.

    7.3k GitHub stars~1.4k tokensUpdated 4 days ago
    Auto-check passed

Works with

Questions about Sonos

What does Sonos do?

Sonos control: search, queue, playlists, rooms/groups, volume, YouTube. Sonos is an agent skill from steipete/agent-scripts. Sonos control: search, queue, playlists, rooms/groups, volume, YouTube.

How do I install Sonos in Claude Code?

Run `npx skills add steipete/agent-scripts --skill sonos -a claude-code`. Or copy the skill folder (skills/sonos in steipete/agent-scripts) into .claude/skills/sonos in your project. Claude Code loads it when a task matches its description.

How do I install Sonos in Codex?

Run `npx skills add steipete/agent-scripts --skill sonos -a codex`. Or copy the skill folder (skills/sonos in steipete/agent-scripts) into .agents/skills/sonos in your project. Codex loads it when a task matches its description.

Can I use Sonos in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add steipete/agent-scripts --skill sonos -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/sonos, .gemini/skills/sonos, .github/skills/sonos and .opencode/skills/sonos in your project.

What does Sonos need to run?

Going by SKILL.md and its folder, Sonos needs the command-line tools its instructions call (rg).

Does Sonos access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Sonos safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Sonos use?

Sonos is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Sonos use?

About 440 tokens (SKILL.md is roughly 1.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Sonos?

Skills that share tags, products or a category with Sonos: Markitdown (ImCa0/just-laws, 782 stars), Banner Design System (nextlevelbuilder/ui-ux-pro-max-skill, 134k stars), Agent Reach (Panniantong/Agent-Reach, 94k stars) and Last30days (mvanhorn/last30days-skill, 64k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Sonos?

steipete (a GitHub user) maintains it in steipete/agent-scripts, which has 7,313 GitHub stars. The repository holds 45 skills in this directory. The repository was last updated on October 4, 2026.

Source: steipete/agent-scripts on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.