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.
Download a video
uv run 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 scripts/url.py --url 'https://example.com/clip.mp4'Chain with inspect
uv run scripts/url.py --url 'https://...' | jq -r '.output_paths[0]' | xargs -I{} uv run ../inspect/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