Code Review
hifiberry/hifiberry-os
Repo-specific guidance for reviewing pull requests on hifiberry-os.
Control Spotify — play music, search the catalog, manage playlists and library, inspect devices and playback state.
MITAuto-check passed
Install Argentos Spotify
$ npx skills add ArgentAIOS/argentos-core --skill argentos-spotify -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install ArgentAIOS/argentos-core argentos-spotify --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/ArgentAIOS/argentos-core.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/hermes/media/spotify .claude/skills/argentos-spotify && rm -rf skills-srcUse ~/.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/
Install the "argentos-spotify" agent skill from https://github.com/ArgentAIOS/argentos-core/tree/main/skills/hermes/media/spotify into .claude/skills/argentos-spotify/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "argentos-spotify", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/ArgentAIOS/argentos-core/tree/main/skills/hermes/media/spotifyType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add ArgentAIOS/argentos-core --skill argentos-spotify -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install ArgentAIOS/argentos-core argentos-spotify --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ArgentAIOS/argentos-core.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/hermes/media/spotify .agents/skills/argentos-spotify && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "argentos-spotify" agent skill from https://github.com/ArgentAIOS/argentos-core/tree/main/skills/hermes/media/spotify into .agents/skills/argentos-spotify/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "argentos-spotify", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ArgentAIOS/argentos-core --skill argentos-spotify -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install ArgentAIOS/argentos-core argentos-spotify --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ArgentAIOS/argentos-core.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/hermes/media/spotify .cursor/skills/argentos-spotify && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "argentos-spotify" agent skill from https://github.com/ArgentAIOS/argentos-core/tree/main/skills/hermes/media/spotify into .cursor/skills/argentos-spotify/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "argentos-spotify", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/ArgentAIOS/argentos-core.git --path skills/hermes/media/spotify--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add ArgentAIOS/argentos-core --skill argentos-spotify -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install ArgentAIOS/argentos-core argentos-spotify --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ArgentAIOS/argentos-core.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/hermes/media/spotify .gemini/skills/argentos-spotify && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "argentos-spotify" agent skill from https://github.com/ArgentAIOS/argentos-core/tree/main/skills/hermes/media/spotify into .gemini/skills/argentos-spotify/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "argentos-spotify", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install ArgentAIOS/argentos-core argentos-spotifyInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add ArgentAIOS/argentos-core --skill argentos-spotify -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/ArgentAIOS/argentos-core.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/hermes/media/spotify .github/skills/argentos-spotify && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "argentos-spotify" agent skill from https://github.com/ArgentAIOS/argentos-core/tree/main/skills/hermes/media/spotify into .github/skills/argentos-spotify/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "argentos-spotify", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ArgentAIOS/argentos-core --skill argentos-spotify -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install ArgentAIOS/argentos-core argentos-spotify --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ArgentAIOS/argentos-core.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/hermes/media/spotify .opencode/skills/argentos-spotify && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "argentos-spotify" agent skill from https://github.com/ArgentAIOS/argentos-core/tree/main/skills/hermes/media/spotify into .opencode/skills/argentos-spotify/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "argentos-spotify", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
argentos-spotify- GitHub stars
- 126
- Token cost
- ~1.7k tokens
- SKILL.md length
- 605 words
- Files
- 1
- Skills in repo
- 7
- Repo updated
- First seen
- Licence
- MIT
At a glance
Control Spotify — play music, search the catalog, manage playlists and library, inspect devices and playback state.
- Works in 3 steps: spotify_playlists list to find the… → Get the track URI (from currently… → spotify_playlists add_items with the…
- Asks to play/pause/queue music
- SKILL.md covers When to use this skill, The 7 tools, Canonical patterns (minimize… and Critical failure modes, plus 2 more sections
- Reaches open.spotify.com
What it does
Argentos Spotify is an agent skill from ArgentAIOS/argentos-core. Control Spotify — play music, search the catalog, manage playlists and library, inspect devices and playback state. Loads when the user asks to play/pause/queue music, search tracks/albums/artists, manage playlists, or check what's playing. Assumes the Hermes Spotify toolset is enabled and hermes auth spotify has been run.
Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It works with Spotify. The repository describes itself as: Your own AI operating system. Self-hosted. Self-improving. One continuous, truthful, self-directed mind. The licence is MIT.
When your agent uses it
- Asks to play/pause/queue music
- Search tracks/albums/artists
- Manage playlists
- Check whats playing
Example prompts
- “/argentos-spotify”
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- spotify_playlists list to find the playlist ID by name
- Get the track URI (from currently playing, or search)
- spotify_playlists add_items with the playlist_id and URIs
What it can do on your machine
Read from SKILL.md and the folder at commit acbf929. 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
No scripts in the folder and no shell commands in SKILL.md.
From the folder's file list and the shell code blocks in SKILL.md.
Network
Hosts in commands or code, which the agent is likely to contact:
open.spotify.com
Also links to:
hermes-agent.nousresearch.com
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
Argentos Spotify loads about 1.7k tokens when it runs. Until then it costs about 86 tokens; SKILL.md has 605 words of instructions outside code blocks.
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 ArgentAIOS/argentos-core at commit acbf929, republished under its MIT licence (© ArgentAIOS). 605 words, ~1,669 tokens.
Download SKILL.mdSave it as
.claude/skills/argentos-spotify/SKILL.md (or your agent's skills folder).- name
- argentos-spotify
- description
- Control Spotify — play music, search the catalog, manage playlists and library, inspect devices and playback state. Loads when the user asks to play/pause/queue music, search tracks/albums/artists, manage playlists, or check what's playing. Assumes the Hermes Spotify toolset is enabled and `hermes auth spotify` has been run.
- version
- 1.0.0
- author
- ArgentOS
- license
- MIT
- prerequisites.tools
- spotify_playback, spotify_devices, spotify_queue, spotify_search, spotify_playlists, spotify_albums, spotify_library
Spotify
Control the user's Spotify account via the Hermes Spotify toolset (7 tools). Setup guide: https://hermes-agent.nousresearch.com/docs/user-guide/features/spotify
When to use this skill
The user says something like "play X", "pause", "skip", "queue up X", "what's playing", "search for X", "add to my X playlist", "make a playlist", "save this to my library", etc.
The 7 tools
spotify_playback— play, pause, next, previous, seek, set_repeat, set_shuffle, set_volume, get_state, get_currently_playing, recently_playedspotify_devices— list, transferspotify_queue— get, addspotify_search— search the catalogspotify_playlists— list, get, create, add_items, remove_items, update_detailsspotify_albums— get, tracksspotify_library— list/save/remove withkind: "tracks"|"albums"
Playback-mutating actions require Spotify Premium; search/library/playlist ops work on Free.
Canonical patterns (minimize tool calls)
"Play <artist/track/album>"
One search, then play by URI. Do NOT loop through search results describing them unless the user asked for options.
spotify_search({"query": "miles davis kind of blue", "types": ["album"], "limit": 1})
→ got album URI spotify:album:1weenld61qoidwYuZ1GESA
spotify_playback({"action": "play", "context_uri": "spotify:album:1weenld61qoidwYuZ1GESA"})For "play some <artist>" (no specific song), prefer types: ["artist"] and play the artist context URI — Spotify handles smart shuffle. If the user says "the song" or "that track", search types: ["track"] and pass uris: [track_uri] to play.
"What's playing?" / "What am I listening to?"
Single call — don't chain get_state after get_currently_playing.
spotify_playback({"action": "get_currently_playing"})If it returns 204/empty (is_playing: false), tell the user nothing is playing. Don't retry.
"Pause" / "Skip" / "Volume 50"
Direct action, no preflight inspection needed.
spotify_playback({"action": "pause"})
spotify_playback({"action": "next"})
spotify_playback({"action": "set_volume", "volume_percent": 50})"Add to my <playlist name> playlist"
spotify_playlists listto find the playlist ID by name- Get the track URI (from currently playing, or search)
spotify_playlists add_itemswith the playlist_id and URIs
spotify_playlists({"action": "list"})
→ found "Late Night Jazz" = 37i9dQZF1DX4wta20PHgwo
spotify_playback({"action": "get_currently_playing"})
→ current track uri = spotify:track:0DiWol3AO6WpXZgp0goxAV
spotify_playlists({"action": "add_items",
"playlist_id": "37i9dQZF1DX4wta20PHgwo",
"uris": ["spotify:track:0DiWol3AO6WpXZgp0goxAV"]})"Create a playlist called X and add the last 3 songs I played"
spotify_playback({"action": "recently_played", "limit": 3})
spotify_playlists({"action": "create", "name": "Focus 2026"})
→ got playlist_id back in response
spotify_playlists({"action": "add_items", "playlist_id": <id>, "uris": [<3 uris>]})"Save / unsave / is this saved?"
Use spotify_library with the right kind.
spotify_library({"kind": "tracks", "action": "save", "uris": ["spotify:track:..."]})
spotify_library({"kind": "albums", "action": "list", "limit": 50})"Transfer playback to my <device>"
spotify_devices({"action": "list"})
→ pick the device_id by matching name/type
spotify_devices({"action": "transfer", "device_id": "<id>", "play": true})Critical failure modes
403 Forbidden — No active device found on any playback action means Spotify isn't running anywhere. Tell the user: "Open Spotify on your phone/desktop/web player first, start any track for a second, then retry." Don't retry the tool call blindly — it will fail the same way. You can call spotify_devices list to confirm; an empty list means no active device.
403 Forbidden — Premium required means the user is on Free and tried to mutate playback. Don't retry; tell them this action needs Premium. Reads still work (search, playlists, library, get_state).
204 No Content on get_currently_playing is NOT an error — it means nothing is playing. The tool returns is_playing: false. Just report that to the user.
429 Too Many Requests = rate limit. Wait and retry once. If it keeps happening, you're looping — stop.
401 Unauthorized after a retry — refresh token revoked. Tell the user to run hermes auth spotify again.
Show full SKILL.md (186 more words)Show less
URI and ID formats
Spotify uses three interchangeable ID formats. The tools accept all three and normalize:
- URI:
spotify:track:0DiWol3AO6WpXZgp0goxAV(preferred) - URL:
https://open.spotify.com/track/0DiWol3AO6WpXZgp0goxAV - Bare ID:
0DiWol3AO6WpXZgp0goxAV
When in doubt, use full URIs. Search results return URIs in the uri field — pass those directly.
Entity types: track, album, artist, playlist, show, episode. Use the right type for the action — spotify_playback.play with a context_uri expects album/playlist/artist; uris expects an array of track URIs.
What NOT to do
- Don't call
get_statebefore every action. Spotify accepts play/pause/skip without preflight. Only inspect state when the user asked "what's playing" or you need to reason about device/track. - Don't describe search results unless asked. If the user said "play X", search, grab the top URI, play it. They'll hear it's wrong if it's wrong.
- Don't retry on
403 Premium requiredor403 No active device. Those are permanent until user action. - Don't use
spotify_searchto find a playlist by name — that searches the public Spotify catalog. User playlists come fromspotify_playlists list. - Don't mix
kind: "tracks"with album URIs inspotify_library(or vice versa). The tool normalizes IDs but the API endpoint differs.
© ArgentAIOS, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/hermes/media/spotify of ArgentAIOS/argentos-core.
Open the folder on GitHubat commit acbf929
Compare with similar skills
Argentos Spotify 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.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Argentos Spotify this skillArgentAIOS/argentos-core | 126 | — | ~1.7k | Automated safety check: Pass | MIT | |
| Code Reviewhifiberry/hifiberry-os | 1.2k | — | ~576 | Automated safety check: Pass | None | |
| UI DesignerAFK-surf/OpenBridge | 430 | — | ~4.6k | Automated safety check: Pass | MIT | |
| Computer Usebam-bam-2/solo-skills | 367 | 1 repos | ~915 | Automated safety check: Pass | MIT | |
| HTML Anythingclockless-org/html-anything | 153 | — | ~6.4k | Automated safety check: Pass | MIT | |
| Deploy To Maven Centralspotify/android-auth | 151 | — | ~717 | Automated safety check: Notes | Apache-2.0 |
Similar skills
UI Designer
AFK-surf/OpenBridge
Design or restyle user interfaces using vendored DESIGN.md references from popular product and brand-inspired visual systems.
Computer Use
bam-bam-2/solo-skills
Use Orca's computer-use CLI to inspect and operate local desktop app windows through accessibility trees, screenshots, and safe UI actions.
HTML Anything
clockless-org/html-anything
Turn rich agent answers and any file, folder, URL, or export into a polished single-file HTML page.
Deploy To Maven Central
spotify/android-auth
Deploys the library to OSSRH staging and creates a pre-release, but publishing must be done manually via the Sonatype web UI.
Android UI Automation
OpenMinis/MinisSkills
Automate Android apps that have no public API or web version by driving the UI layer through the Accessibility Service.
More from ArgentAIOS/argentos-core
Argentos Dev Ops
ArgentAIOS/argentos-core
ArgentOS development operations workflow — Linear tracking, CodeRabbit reviews, Blacksmith CI, GitHub branch protection, and inter-agent handoff protocol.
Community Google Workspace
ArgentAIOS/argentos-core
Gmail, Calendar, Drive, Contacts, Sheets, and Docs integration for community skills.
Argentos Design Md
ArgentAIOS/argentos-core
Author, validate, diff, and export DESIGN.md files — Google's open-source format spec that gives coding agents a persistent, structured understanding of a design system (tokens + rationale in one…
Argentos Release Checklist
ArgentAIOS/argentos-core
End-to-end release checklist for ArgentOS across all repos and services.
Argentos Repo Inventory
ArgentAIOS/argentos-core
Complete inventory of ArgentOS repos, databases, services, and infrastructure.
Workforce Setup
ArgentAIOS/argentos-core
Guide the operator through creating a workforce role, drafting the relationship contract, choosing the target family/primary agent, and starting the worker in the correct staged mode.
Related
Works with
Questions about Argentos Spotify
What does Argentos Spotify do?
Control Spotify — play music, search the catalog, manage playlists and library, inspect devices and playback state. Argentos Spotify is an agent skill from ArgentAIOS/argentos-core. Control Spotify — play music, search the catalog, manage playlists and library, inspect devices and playback state.
When should I use Argentos Spotify?
Argentos Spotify fits situations like: asks to play/pause/queue music; search tracks/albums/artists; manage playlists; check whats playing.
How do I install Argentos Spotify in Claude Code?
Run `npx skills add ArgentAIOS/argentos-core --skill argentos-spotify -a claude-code`. Or copy the skill folder (skills/hermes/media/spotify in ArgentAIOS/argentos-core) into .claude/skills/argentos-spotify in your project. Claude Code loads it when a task matches its description.
How do I install Argentos Spotify in Codex?
Run `npx skills add ArgentAIOS/argentos-core --skill argentos-spotify -a codex`. Or copy the skill folder (skills/hermes/media/spotify in ArgentAIOS/argentos-core) into .agents/skills/argentos-spotify in your project. Codex loads it when a task matches its description.
Can I use Argentos Spotify 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 ArgentAIOS/argentos-core --skill argentos-spotify -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/argentos-spotify, .gemini/skills/argentos-spotify, .github/skills/argentos-spotify and .opencode/skills/argentos-spotify in your project.
What does Argentos Spotify need to run?
SKILL.md names no scripts, command-line tools or credentials: Argentos Spotify is instructions for the agent only.
Does Argentos Spotify access the network?
SKILL.md names 2 domains. In commands or code: open.spotify.com; the agent is likely to contact it when it follows the instructions. As links in the text: hermes-agent.nousresearch.com. This is read from the text; nothing was executed.
Is Argentos Spotify 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 Argentos Spotify use?
Argentos Spotify is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Argentos Spotify use?
About 1.7k tokens (SKILL.md is roughly 6.7k 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 Argentos Spotify?
Skills that share tags, products or a category with Argentos Spotify: Code Review (hifiberry/hifiberry-os, 1.2k stars), UI Designer (AFK-surf/OpenBridge, 430 stars), Computer Use (bam-bam-2/solo-skills, 367 stars) and HTML Anything (clockless-org/html-anything, 153 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Argentos Spotify?
ArgentAIOS (a GitHub organization) maintains it in ArgentAIOS/argentos-core, which has 126 GitHub stars. The repository holds 7 skills in this directory. The repository was last updated on July 9, 2026.
Source: ArgentAIOS/argentos-core on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.