← Back to Skills Marketplace
264
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install yandex-music
Description
Inspect Yandex Music via the MarshalX yandex-music library. Use when the user wants Yandex Music search, current track lookup, liked tracks, playlists, or a...
README (SKILL.md)
Yandex Music Control
Use the bundled helper script for deterministic operations instead of rewriting API snippets.
First use
- Read
references/token-and-control.md. - Check whether the token is already available via
YM_TOKENor the workspace config file. - If the token is missing, ask the user for a token or guide them to provide one; do not invent an extraction flow.
- Validate the token with:
scripts/ymctl.py auth-check
Runtime
Prefer the skill-local virtualenv interpreter when present:
./.venv/bin/python scripts/ymctl.py ...
If .venv is missing, create it and install the library:
python3 -m venv .venv
./.venv/bin/pip install yandex-music
Save token
./.venv/bin/python scripts/ymctl.py auth-set \x3CTOKEN>
./.venv/bin/python scripts/ymctl.py auth-set \x3CTOKEN> --device '\x3Cdevice-id>'
./.venv/bin/python scripts/ymctl.py auth-where
./.venv/bin/python scripts/ymctl.py auth-clear
Default config path:
/root/.openclaw/workspace/.openclaw/yandex-music-control/config.json
Common commands
Search tracks:
./.venv/bin/python scripts/ymctl.py search 'кино группа крови'
./.venv/bin/python scripts/ymctl.py search 'масло черного тмина' --type artist
Current track:
./.venv/bin/python scripts/ymctl.py now-playing
Likes and playlists:
./.venv/bin/python scripts/ymctl.py likes --limit 20
./.venv/bin/python scripts/ymctl.py playlists
./.venv/bin/python scripts/ymctl.py like 'shortparis страшно'
./.venv/bin/python scripts/ymctl.py unlike 'shortparis страшно'
Behavior rules
- This skill is read/search oriented: do not claim live transport control.
now-playinguses a local Ynison websocket probe for modern clients.- Do not echo secrets back into chat.
- Keep token handling local to env vars or the workspace config file.
Files
- Helper script:
scripts/ymctl.py - Control/token notes:
references/token-and-control.md
Usage Guidance
This skill appears to do what it says: it uses a bundled Python helper to call Yandex Music APIs and Ynison websocket endpoints. Before installing, consider: (1) you must provide a Yandex Music token (YM_TOKEN or via auth-set), and that token will be saved in the workspace config file under the skill directory (config file is created with 0600 permissions). (2) The skill will create a local virtualenv and pip-install the 'yandex-music' package from PyPI — if you prefer, run these steps manually in an isolated environment. (3) The script opens websocket/HTTP connections to Yandex hosts (expected for now-playing queries). (4) If you have concerns, review the bundled scripts (scripts/ymctl.py and references/token-and-control.md) yourself; the SKILL.md explicitly warns not to echo secrets and not to implement automated extraction flows.
Capability Analysis
Type: OpenClaw Skill
Name: yandex-music
Version: 1.0.0
The skill provides a legitimate interface for Yandex Music using the MarshalX yandex-music library. The helper script (scripts/ymctl.py) implements standard API interactions and a WebSocket-based 'Ynison' probe for retrieving current playback status. Security best practices are followed, including restricting config file permissions to 0600, redacting tokens in output, and providing explicit instructions in SKILL.md and references/token-and-control.md to prevent the AI agent from leaking secrets or performing unauthorized token extraction.
Capability Assessment
Purpose & Capability
Name/description, SKILL.md, and the included helper script (scripts/ymctl.py) all implement Yandex Music inspection (search, now-playing via Ynison, likes, playlists, token storage). Required capabilities (websocket/API calls to Yandex) match the stated purpose.
Instruction Scope
Runtime instructions are specific: prefer a skill-local .venv, install the official yandex-music package, use YM_TOKEN or workspace config, validate tokens, and avoid echoing secrets. The script reads/writes a workspace-local config file and opens websockets/HTTP connections to Yandex endpoints (ynison/music.yandex.ru), which is appropriate for now-playing queries. Note: SKILL.md explicitly instructs not to implement any secret-extraction automation and to ask the user for tokens.
Install Mechanism
No global install spec in the registry (instruction-only), but SKILL.md tells the agent to create a local Python venv and pip-install the 'yandex-music' package from PyPI. This is a reasonable, proportional approach for a Python helper script. No downloads from untrusted URLs are present.
Credentials
The skill does not declare required env vars in registry metadata, but both SKILL.md and the script use/accept YM_TOKEN as an environment source and allow persisting a token to the workspace config. That mismatch is minor but worth noting: supplying a YM_TOKEN is expected to use the skill, and tokens will be stored locally at the skill's workspace config path (written with mode 0600).
Persistence & Privilege
Skill is not always-enabled and can be invoked by the user. It stores its own workspace-local config file (no evidence it modifies other skills or global agent settings). It needs runtime network access to Yandex services to function, which is appropriate for its purpose.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install yandex-music - After installation, invoke the skill by name or use
/yandex-music - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
- Initial release of the Yandex Music control skill using the MarshalX yandex-music library.
- Provides search, current track lookup, liked tracks, and playlists lookup via bundled helper script.
- Adds workflow for Yandex Music token setup, validation, and storage using scripts/ymctl.py.
- Emphasizes deterministic script use instead of ad-hoc API snippets.
- Keeps token management local and never exposes secrets in chat.
- Clear, command-based interface for common Yandex Music queries and actions.
Metadata
Frequently Asked Questions
What is Yandex Music?
Inspect Yandex Music via the MarshalX yandex-music library. Use when the user wants Yandex Music search, current track lookup, liked tracks, playlists, or a... It is an AI Agent Skill for Claude Code / OpenClaw, with 264 downloads so far.
How do I install Yandex Music?
Run "/install yandex-music" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Yandex Music free?
Yes, Yandex Music is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Yandex Music support?
Yandex Music is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Yandex Music?
It is built and maintained by prtolem (@prtolem); the current version is v1.0.0.
More Skills