Overview
Requires yt-dlp on PATH. Scripts are Python 3.11+, run via `uv run`. Network access required.
Recipes
Copy-paste command sequences agents can run via uv run. Replace <skill_directory> with the absolute path of this skill (the folder that contains SKILL.md) — do not run scripts/… relative to cwd.
Download a video
uv run <skill_directory>/scripts/url.py --url 'https://www.youtube.com/watch?v=dQw4w9WgXcQ'Example JSON output
{"ok": true, "op": "download.url", "data": {"url": "...", "output_path": "/path/.mediaskills/downloads/Title [id].mp4", "output_dir": "/path/.mediaskills/downloads"}, "output_paths": ["..."]}Custom data directory (CI or server)
export MEDIASKILLS_DATA_DIR=/var/mediaskills
uv run <skill_directory>/scripts/url.py --url 'https://example.com/clip.mp4'Chain with inspect
uv run <skill_directory>/scripts/url.py --url 'https://...' | jq -r '.output_paths[0]' | xargs -I{} uv run <inspect_skill_directory>/scripts/probe.py --input {}Operations
Each script returns structured JSON — see the script contract.
| Op ID | Script | Common flags |
|---|---|---|
download.url | url.py | --url |
Do not use for
- Local file processing without a URL
- DRM-protected streams you cannot access with yt-dlp