download-video

Download embedded videos from Vimeo, YouTube, Wistia, Brightcove, and Loom pages.

154|9|Updated Mar 27, 2026
One-click install
npx skills add https://github.com/swyxio/skills --skill download-video-swyxio
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: download-video
Source: https://github.com/swyxio/skills/tree/main/download-video
Command: npx skills add https://github.com/swyxio/skills --skill download-video-swyxio

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Many embedded videos on event pages, course platforms, and forums are private, unlisted, or protected by referer restrictions, making direct URL downloads fail with 404 or 403 errors.

Core Features & Use Cases

  • Embed URL Resolution: Automatically identifies and resolves the correct embed/player URL for Vimeo, YouTube, Wistia, Brightcove, Loom, and other yt-dlp supported hosts, even when the direct public URL is inaccessible.
  • Header Automation: Adds required referer and origin headers for content protected by domain restrictions, eliminating manual header configuration.
  • Fallback Download Patterns: Uses progressive yt-dlp invocation attempts to handle common errors like OAuth token failures, 404s, and 403s for reliable downloads.
  • Use Case: Download a private Vimeo embed from an event replay page that returns a 404 error when accessed via the direct public URL.

Quick Start

Use the download-video skill to save the embedded video from the provided event page URL to your local machine.

Frequently Asked Questions about download-video

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I download private embedded videos that return a 403 or 404 error?

Downloading private embedded videos requires resolving the embed URL and passing required referer headers. This skill automates that process by inspecting page source and executing yt-dlp with progressive fallback patterns to bypass 403 and 404 errors.

What is the best way to download a Vimeo event replay restricted by referer settings?

Downloading a Vimeo event replay restricted by referer settings involves injecting origin headers. This skill identifies the correct embed player URL and automatically adds necessary HTTP headers to retrieve the local media file successfully.

Does yt-dlp support downloading embedded videos from Wistia, Brightcove, and Loom?

yt-dlp supports downloading embedded videos from Wistia, Brightcove, and Loom when provided the correct embed URL. This skill resolves those player URLs from the page source to enable media extraction from these supported hosts.

Why does downloading an unlisted YouTube video via direct public URL fail?

Downloading an unlisted YouTube video via direct public URL fails due to privacy settings and embed-only hosting configurations. Resolving the valid embed URL from the page source bypasses this restriction and allows successful video extraction.

Can I download course videos automatically without manually configuring HTTP headers?

You can download course videos without manual HTTP header configuration. This skill automates header injection for referer and origin restrictions, executing yt-dlp to retrieve media from protected course platforms automatically.

What are the limitations when extracting media from private webinar recordings?

Limitations when extracting media from private webinar recordings include OAuth token failures and strict domain restrictions. This skill uses progressive yt-dlp invocation attempts to handle these errors, but cannot bypass authentication requiring active login credentials.