Install

Two commands and a key.

The skill is a markdown file. The tools come from the hosted MCP server. There is no Python, no yt-dlp, and no ffmpeg to install on your machine.

Install for both clients

The installer writes one SKILL.md per client and prints the MCP config.

install
# 1. create a key at https://videodownloadmcp.com/settings/apikeys
export VIDEODOWNLOAD_API_KEY=vd_your_key

# 2. install the skill file for Claude Code and Codex
npx -y @videodownload/skill install

# 3. connect the hosted MCP server (Claude Code example)
claude mcp add --transport http videodownload \
  https://videodownloadmcp.com/mcp \
  --header "Authorization: Bearer $VIDEODOWNLOAD_API_KEY"

What gets written

Claude Code
~/.claude/skills/video-download/SKILL.md
Codex
~/.codex/skills/video-download/SKILL.md
API key
not written; stays in your shell env

Prefer not to run the installer? Download the file directly:

/video-download/SKILL.md

Manual install

The skill file is static. Copy it to either skills directory if you already have one.

curl
mkdir -p ~/.claude/skills/video-download
curl -fsSL https://videodownloadskill.com/video-download/SKILL.md \
  -o ~/.claude/skills/video-download/SKILL.md

mkdir -p ~/.codex/skills/video-download
curl -fsSL https://videodownloadskill.com/video-download/SKILL.md \
  -o ~/.codex/skills/video-download/SKILL.md

Claude Code reads skills from ~/.claude/skills. Codex reads them from ~/.codex/skills.

The skill is loaded at the start of a session. Restart the client after copying the file.

Verify the first call

A resolve call does not spend a credit. If it returns a title, the key and endpoint are working.

session
# ask the agent to resolve a public link
"Resolve https://www.youtube.com/watch?v=aqz-KE-bpKQ"

# expected first tool call
resolve_video({ "url": "https://www.youtube.com/watch?v=aqz-KE-bpKQ" })

# then, if the user wants a file
download_video({ "url": "...", "format": "mp4", "quality": "1080p" })

troubleshooting

  • 401: the key is missing or deleted. Re-run the MCP add command with a new key.
  • No tools: the MCP server is not connected. Check the client's MCP status page.
  • Skill not used: the agent did not load the skill. Confirm the SKILL.md path and restart the session.

Install questions

The installer is intentionally small: copy one file, print one config, count one install.

Where does the installer put the files?+

By default it writes ~/.claude/skills/video-download/SKILL.md and ~/.codex/skills/video-download/SKILL.md. Pass --target claude or --target codex to install one, or --dir to use a custom skills directory.

Do I still need the MCP server config?+

Yes. The skill tells the agent when and how to call the tools, and the MCP server provides the tools. The install command prints a client config; the MCP page has the full set.

Does the installer send my API key?+

No. It never reads the key. It copies a static markdown file and, unless --no-telemetry is passed, posts an anonymous install count with no key and no URL.

How do I update the skill?+

Run the install command again. It overwrites the SKILL.md file. Your API key stays in your environment, not in the skill file.

Add the agent tools once.

Every session after that can resolve and download public video.

See agent prompts