media-downloader_skill

Overview

This skill is a smart media downloader that automatically searches for and downloads images and video clips based on a user description. It supports free stock sources, YouTube downloads, and automatic trimming of video segments. The skill handles API key prompting for image providers when needed and saves files to a consistent local download folder.

How this skill works

You describe the media you need and the skill searches supported sources (Pexels, Pixabay, Unsplash) for images and stock clips, or prioritizes YouTube when a video source is not specified. For images, it checks for a configured PEXELS_API_KEY and prompts the user to supply and persist one if missing. For videos it can download full clips, extract audio, or auto-trim a specified time range using ffmpeg.

When to use it

• Quickly gather multiple stock images for design or presentations
• Download short video clips or background footage for editing
• Grab and trim a specific segment from a YouTube link
• Fetch asset batches for prototypes, social posts, or storyboards
• Collect royalty-free media for commercial use without manual search

Best practices

• Provide concise search terms and desired quantity or clip duration
• When asking for YouTube trims, give start and end times in seconds or mm:ss
• Install required tools locally: yt-dlp for YouTube, ffmpeg for trimming
• If prompted, follow the Pexels API key setup and paste the key when ready
• Review downloaded files in ~/.claude/skills/media-downloader/downloads/ and rename as needed

Example use cases

• "Download 5 sunset wallpapers" — searches and saves high-res images
• "Find a 15-second ocean wave video" — finds and downloads a stock clip
• "Download https://youtube.com/watch?v=xxx from 1:30 to 2:00" — downloads and trims the segment
• "Get 10 coffee shop photos for a mood board" — bulk image download for creative work
• "Only download audio from this YouTube video" — extract and save audio track