Agent task guide

Download your YouTube videos with Claude Code.

Ask Claude Code for a video at the quality and size you want. With the lyt skill installed, it runs one command and reports the saved path from structured JSON.

How do I install the lyt skill for Claude Code?

Requires Node.js 20 or newer and a terminal the agent can run. Approve global installation and managed tool setup once. Network access to the media host is required. ffmpeg is needed for MP3 conversion, video merging, and clips.

npm install --global @tanattv/lyt
lyt agent install claude
lyt doctor --json
lyt capabilities --json

Codex user skills live in ~/.agents/skills/lyt/. Claude Code skills live in ~/.claude/skills/lyt/. An installed and enabled skill can be selected for matching tasks; selection depends on the agent.

What should I ask Claude Code?

This is my video. Download it at up to 1080p, keep it under 100 MB, and give me the saved path.

Replace URL with your media link. Ownership, permission, licenses, public domain, or applicable exceptions can support the download. Downloading does not establish publication rights.

How does Claude Code check the media before downloading?

Inspection contacts the media host but does not download media. With --no-download it also avoids provisioning tools.

lyt info --no-download --json "URL"
lyt --video -q 1080p --max-filesize 100M --json "URL"

A quality setting is a cap, not a guarantee that the source offers that resolution.

How does Claude Code know where the file was saved?

This is an illustrative success response. Names and paths depend on the source and output directory. Read JSON from stdout and diagnostics from stderr. Check the exit status and ok before using results[].files.

{
  "schema": "lyt.result.v1",
  "version": "0.8.2",
  "command": "download",
  "ok": true,
  "results": [
    {
      "url": "URL",
      "status": "downloaded",
      "mode": "video",
      "files": [
        "/downloads/example.mp4"
      ],
      "outputDir": "/downloads"
    }
  ]
}

Failure must not be reported as a saved file. Verify that successful paths exist. Playlist downloads and overwrites remain opt-in.

What if the download or setup fails?

Run lyt doctor --json for missing tools. A certificate trust error may require correctly configuring your environment's trusted certificates. Do not disable certificate verification as a default fix. A host or network proxy may return an HTML error page instead of media, causing an invalid-input conversion error. That needs an access or network fix; lyt cannot guarantee access from a restricted agent environment.

Related guides

GuideSave YouTube audio as MP3 with CodexGuideClip a video with your AI coding agentReferenceEvery lyt command, ready to copy
FAQ

Frequently asked questions

How do I set up the lyt skill in Claude Code?

Install the CLI with npm install --global @tanattv/lyt, run lyt doctor, then run lyt agent install claude. The skill is installed to ~/.claude/skills/lyt/ and can be selected for matching tasks.

Can Claude Code download a YouTube video at 1080p with lyt?

Yes. A request can use lyt --video -q 1080p --json "URL". The 1080p setting is a cap, not a guarantee, because the source may offer only lower resolutions. Add --max-filesize to keep the file under your limit.

Does video download with lyt need ffmpeg?

Video merging needs ffmpeg. On Windows lyt can provision a verified ffmpeg build. On macOS and Linux, lyt doctor shows the package-manager command to install it.

How can Claude Code check a video before downloading it?

Run lyt info --no-download --json "URL" to read the title, duration, and available formats. Inspection contacts the media host but downloads no media.

Agent setup guideAI product facts