← Back to Skills Marketplace
Media Orchestrator
by
Sieer Shafi Lone
· GitHub ↗
· v0.1.1
1373
Downloads
0
Stars
1
Active Installs
2
Versions
Install in OpenClaw
/install media-orchestrator
Description
Unified skill for resolving, downloading, and delivering media (audio/video) to chat platforms. Integrates yt-dlp for resolution and handles Spotify metadata sync.
Usage Guidance
Key things to consider before installing:
- The skill will execute yt-dlp (python -m yt_dlp) and optionally ffmpeg; these dependencies are not declared or installed by the skill. Ensure your environment has safe, vetted versions of yt-dlp and ffmpeg, and consider running in a sandbox.
- The orchestrator hardcodes /home/ky11rie/.openclaw/workspace and calls another skill's script at workspace/skills/spotify-surface/scripts/spotify_surface.py. That means it expects and will execute code from other skills in the shared workspace — review spotify_surface.py (and any other referenced scripts) before enabling this skill.
- The SKILL.md mentions 'Zero-Auth scraping' for Spotify metadata. Scraping can bypass APIs and may fetch data from third-party sites; check spotify_surface.py for network endpoints, credential usage, and compliance with service terms.
- The script invokes the host CLI 'openclaw message send' to deliver files. Confirm that the message tool behaves as you expect and that the skill cannot send arbitrary filesystem files beyond its intended downloads.
- Because the skill has exec + filesystem permissions and runs subprocesses, prefer installing only if you trust the source or after auditing the included scripts (spotify_surface and any invoked binaries). If you cannot review them, run the skill in an isolated environment with restricted filesystem/network access.
- If you want to proceed but reduce risk: require the skill to declare/install yt-dlp/ffmpeg, remove hardcoded user paths (use workspace variable injection), and explicitly document the spotify_surface dependency and any credentials it needs.
Capability Analysis
Type: OpenClaw Skill
Name: media-orchestrator
Version: 0.1.1
The skill is designed to resolve, download, and deliver media using `yt-dlp` and a local `spotify-surface` script. The `orchestrator.py` script uses `subprocess.run` to execute necessary tools (`yt-dlp`, `openclaw message`, `python3 spotify_surface.py`) but passes user-controlled inputs as distinct arguments in lists, mitigating shell injection risks. File operations are confined to the OpenClaw workspace. The `SKILL.md` contains no prompt injection attempts. While the term 'Zero-Auth scraping' for Spotify metadata is noted, its stated purpose is local metadata resolution, not exfiltration, and the implementation delegates to a local script without showing malicious intent in the provided files.
Capability Assessment
Purpose & Capability
Name/description (resolve, download, deliver media) aligns with the script's behavior: it invokes yt-dlp, writes downloads to workspace, and calls the OpenClaw 'message' CLI to send files. However the skill hardcodes a specific user workspace path (/home/ky11rie/.openclaw/workspace) and expects/executes another skill's script (spotify_surface) in that path — that is unusual and not justified in the manifest. The manifest lists exec and filesystem read/write permissions which are consistent, but cross-skill execution is a design choice that should be explicit.
Instruction Scope
SKILL.md and orchestrator.py instruct the agent to: run yt-dlp (python -m yt_dlp) to download media into the workspace, call a spotify_surface script via subprocess for Spotify requests, and call an 'openclaw message send' CLI to deliver files. These instructions read/write workspace files and execute other skill scripts. The SKILL.md explicitly mentions 'Zero-Auth scraping' for Spotify metadata — that implies scraping behavior that may access external endpoints and bypass official APIs. The script does not attempt to read arbitrary host files, but executing another skill's script and writing persistent JSON contracts in workspace increases scope beyond a simple downloader.
Install Mechanism
This is instruction-plus-code with no install spec. The script assumes availability of python3, yt-dlp (python module), and possibly ffmpeg/ffprobe; none are declared for installation. Not providing an install mechanism is lower risk for arbitrary network fetches, but it also makes runtime failures likely or hides implicit dependency requirements. No external downloads are executed by the skill itself, which reduces immediate install risk.
Credentials
The manifest declares exec and filesystem permissions but no environment variables or credentials. The script executes another skill (spotify_surface.py) that may rely on credentials or perform scraping, yet those requirements are not declared. The lack of declared dependencies/credentials while executing cross-skill code is disproportionate: the orchestrator can trigger code that might access secrets or external services without making those needs explicit.
Persistence & Privilege
always:false (no forced global inclusion). The skill writes/downloads into the workspace and persists Spotify JSON contracts there; that is expected for its purpose. It does not modify other skills' configuration or request permanent presence. The main privilege concern is the ability to execute other skill scripts in the shared workspace, which can increase blast radius but is not itself set as a persistent or always-enabled capability.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install media-orchestrator - After installation, invoke the skill by name or use
/media-orchestrator - Provide required inputs per the skill's parameter spec and get structured output
Version History
v0.1.1
- Internal code updates in scripts/orchestrator.py; no user-facing changes.
- No updates to documentation or features.
v0.1.0
Initial release of media-orchestrator skill.
- Centralizes media handling for audio, video, and Spotify requests across chat platforms (WhatsApp, Telegram).
- Integrates yt-dlp for searching and downloading media from YouTube.
- Supports Spotify track metadata resolution and syncs metadata as JSON for OpenClaw WebUI.
- Automates media delivery to chat platforms using the message tool.
- Defines clear workspace directory structure for downloaded files and Spotify metadata.
Metadata
Frequently Asked Questions
What is Media Orchestrator?
Unified skill for resolving, downloading, and delivering media (audio/video) to chat platforms. Integrates yt-dlp for resolution and handles Spotify metadata sync. It is an AI Agent Skill for Claude Code / OpenClaw, with 1373 downloads so far.
How do I install Media Orchestrator?
Run "/install media-orchestrator" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Media Orchestrator free?
Yes, Media Orchestrator is completely free (open-source). You can download, install and use it at no cost.
Which platforms does Media Orchestrator support?
Media Orchestrator is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Media Orchestrator?
It is built and maintained by Sieer Shafi Lone (@sieershafilone); the current version is v0.1.1.
More Skills