ClawHub

yt-dlp

v1.0.0

AI skill to analyze song requests, verify local workspace files, and download missing tracks directly from YouTube bypassing API limits.

⭐ 0· 222·0 current·0 all-time
by@nhathuynguyen19

Install

OpenClaw Prompt Flow

Install with OpenClaw

Best for remote or guided setup. Copy the exact prompt, then paste it into OpenClaw for nhathuynguyen19/yt-dlp-cmus.

Previewing Install & Setup.
Prompt PreviewInstall & Setup
Install the skill "yt-dlp" (nhathuynguyen19/yt-dlp-cmus) from ClawHub.
Skill page: https://clawhub.ai/nhathuynguyen19/yt-dlp-cmus
Keep the work scoped to this skill only.
After install, inspect the skill metadata and help me finish setup.
Required binaries: yt-dlp, ffmpeg
Use only the metadata you can verify from ClawHub; do not invent missing requirements.
Ask before making any broader environment changes.

Command Line

CLI Commands

Use the direct CLI path if you want to install manually and keep every step visible.

OpenClaw CLI

Bare skill slug

openclaw skills install yt-dlp-cmus

ClawHub CLI

Package manager switcher

npx clawhub@latest install yt-dlp-cmus
Security Scan
VirusTotalVirusTotal
Benign
View report →
OpenClawOpenClaw
Benign
high confidence
✓
Purpose & Capability
The skill declares yt-dlp and ffmpeg (both required to download and convert audio) and its instructions show exactly how those binaries are used. There are no unrelated binaries, env vars, or config paths requested.
✓
Instruction Scope
SKILL.md confines activity to the user's workspace (~/.openclaw/workspace/music/), describes checking for existing files and downloading only missing tracks, and does not instruct reading unrelated files or exfiltrating data. It does run shell commands (find, mkdir, cd, yt-dlp), which is expected for this purpose.
ℹ
Install Mechanism
The registry lists this as an instruction-only skill (no install spec), but the SKILL.md metadata includes suggested install entries (apt ffmpeg, pip yt-dlp). This is an internal inconsistency: the skill itself suggests how to install dependencies, but the package does not include an authoritative install step in the registry.
✓
Credentials
No credentials or sensitive environment variables are requested. The only filesystem access is the user-scoped workspace directory, which is appropriate for the stated function.
✓
Persistence & Privilege
The skill does not request always:true or other elevated persistence. It is user-invocable and allows autonomous invocation (the platform default), which is expected for a functional skill.
Assessment
This skill appears coherent for its purpose, but review these practical points before installing: 1) The skill executes shell commands that will download files from the Internet into ~/.openclaw/workspace/music/ — ensure you are comfortable with that location and its permissions. 2) There is a small metadata inconsistency: the SKILL.md suggests apt/pip install steps but the registry provides no install spec; the agent likely won't auto-install yt-dlp/ffmpeg for you. 3) Install yt-dlp and ffmpeg from trusted sources (official repos or releases) before use. 4) Be aware of legal and terms-of-service issues when downloading copyrighted content. 5) If you do not fully trust the skill owner, consider running the commands manually first or using a sandboxed environment; review any future updates for changes to the instructions. Overall, nothing in the skill asks for unrelated credentials or system-wide access, but exercise normal caution with tools that run shell commands and fetch external content.

Like a lobster shell, security has layers — review code before you run it.

Runtime requirements

📥 Clawdis
Binsyt-dlp, ffmpeg
latestvk9785dd9bre1gqvzhy4w8pzwz183nvce
222downloads
0stars
1versions
Updated 1mo ago
v1.0.0
MIT-0
@nhathuynguyen19
latest
Download

yt-dlp (OpenClaw Music Fetcher)

Workflow: Analyze prompt -> Identify specific track -> Check ~/.openclaw/workspace/music/ folder -> Download if missing -> Pass to cmus.

Find the active workspace music folder

The agent must always operate within the specific OpenClaw workspace directory to ensure portability.

  • Path: ~/.openclaw/workspace/music/ (Resolved as an absolute path from the user's home directory).
  • Never download files to the root, current working directory, or system folders.

Track Identification & Verification Logic

When the user requests a song (via lyrics, artist, composer, or title):

  1. Analyze: Determine the exact track name and artist.
  2. Check Local: Search the workspace music folder: find ~/.openclaw/workspace/music/ -type f -iname "*<keyword>*"
  3. Branching:
    • If the file EXISTS: Skip download. Pass the absolute file path to the cmus skill.
    • If the file is MISSING: Proceed to the download step using yt-dlp.

yt-dlp quick start

Ensure the directory exists, navigate to it, and download the missing track. The ytsearch1: prefix is used to grab the best match from YouTube Music/YouTube automatically:

  • mkdir -p ~/.openclaw/workspace/music/ && cd ~/.openclaw/workspace/music/ && yt-dlp -x --audio-format mp3 -o "%(title)s.%(ext)s" "ytsearch1:<Exact Track Name> <Artist>"

Notes

  • Post-Download Action: Always wait for the download to finish, then run find again to capture the final filename (as yt-dlp sanitizes titles) before passing it to cmus.
  • Generalization: Use ~ or $HOME instead of hardcoded paths like /home/huy/ to ensure the skill works for all users.
  • Dependency: yt-dlp requires ffmpeg to extract and convert audio streams into .mp3 format.
  • Prefer highly specific search queries (Track + Artist) to ensure the agent picks the correct version of a song.

Comments

Loading comments...