← Back to Skills Marketplace
Social Downloader
by
OliverHenry
· GitHub ↗
· v1.0.0
· MIT-0
61
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install social-downloader
Description
Download TikTok, Instagram Reel, X/Twitter video, YouTube Short, or other social video links with yt-dlp. Use when the user asks to download/save/send a soci...
README (SKILL.md)
Social Downloader
Use this for social video links.
Modes
1. Download best quality and send back
bash skills/social-downloader/scripts/download_best.sh "\x3Curl>" /tmp/social-download
Then inspect the output and send the downloaded video back to the user.
2. Download + transcribe for skill creation
python3 skills/social-downloader/scripts/download_transcribe.py "\x3Curl>" --out /tmp/social-skill-source
Then:
- Read the transcript.
- Extract the reusable workflow.
- Create or update a concise OpenClaw skill.
Rules
- Prefer best available quality with
yt-dlp. - Do not re-encode unless needed for compatibility or file size.
- Keep downloaded files in a clear local output folder.
- Never hardcode cookies, API keys, auth tokens, or private credentials into the skill.
- If a site requires login/cookies, ask before using a logged-in browser/session.
Usage Guidance
This appears safe for its stated purpose. Before installing, make sure you are comfortable running yt-dlp and ffmpeg locally, and be aware that transcription mode can use your OpenAI API key and send the video's audio to OpenAI.
Capability Analysis
Type: OpenClaw Skill
Name: social-downloader
Version: 1.0.0
The skill provides functionality to download and transcribe social media videos using yt-dlp and OpenAI's API. However, it contains a shell injection vulnerability in `scripts/download_best.sh` where the `$URL` parameter is passed directly to a shell command without sanitization. Additionally, `scripts/download_transcribe.py` accesses the user's `OPENAI_API_KEY` to exfiltrate audio data to OpenAI's transcription endpoint; while this aligns with the stated purpose, the use of a non-standard model name ('gpt-4o-mini-transcribe') and manual multipart request construction warrants caution.
Capability Tags
Capability Assessment
Purpose & Capability
The download and transcription behavior matches the stated social-video downloader purpose, including yt-dlp-based downloads and optional transcript generation.
Instruction Scope
The SKILL.md presents user-directed commands and includes a rule to ask before using logged-in browser sessions or cookies.
Install Mechanism
There is no install spec and metadata declares no required binaries, but the scripts require local yt-dlp and ffmpeg to work.
Credentials
The transcription script uses OPENAI_API_KEY if present and uploads extracted audio to OpenAI; this is purpose-aligned but not declared in the metadata.
Persistence & Privilege
The skill writes downloaded media, audio, transcript, and result files to user-specified output folders and shows no background persistence or privilege escalation.
How to Use
- Make sure OpenClaw is installed (local or Docker)
- Run the install command in chat:
/install social-downloader - After installation, invoke the skill by name or use
/social-downloader - Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Add yt-dlp based best-quality social video download and transcript workflow
Metadata
Frequently Asked Questions
What is Social Downloader?
Download TikTok, Instagram Reel, X/Twitter video, YouTube Short, or other social video links with yt-dlp. Use when the user asks to download/save/send a soci... It is an AI Agent Skill for Claude Code / OpenClaw, with 61 downloads so far.
How do I install Social Downloader?
Run "/install social-downloader" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.
Is Social Downloader free?
Yes, Social Downloader is completely free, licensed under MIT-0. You can download, install and use it at no cost.
Which platforms does Social Downloader support?
Social Downloader is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).
Who created Social Downloader?
It is built and maintained by OliverHenry (@olliewazza); the current version is v1.0.0.
More Skills