How do I install the Video Intel skill?

Run npx skillmds@latest add knownasnaffy/video-intel-3 in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Video Intel safe to use?

This skill has not completed SkillMD's automated safety review yet. Capability flags: executes scripts, makes network calls. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Video Intel?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Video Intel free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Video Intel?

knownasnaffy (@knownasnaffy) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Video Intel by knownasnaffy — Agent Skill

Name: Video Intel
Rating: 4.2 (5 reviews)
Author: knownasnaffy

Video Intel

Download videos and get transcripts, summaries, or metadata from YouTube, TikTok, Instagram, and X (Twitter). Use when the user shares a video URL and wants a transcript, summary, key points, quotes, or to download the video. Triggers on phrases like "transcript this video", "summarize this YouTube video", "what does this video say", "download this TikTok", "get captions from", or any video URL from youtube.com, youtu.be, tiktok.com, instagram.com, x.com, twitter.com. Requires: yt-dlp, python3, curl. Optional: ffmpeg (for TikTok/Instagram/X audio), OPENAI_API_KEY (Whisper fallback — uploads audio to OpenAI).

knownasnaffy Updated Sep 22, 2026 0 repo stars

File contents

video-intel

Downloads videos and extracts transcripts using yt-dlp (captions) with OpenAI Whisper fallback.

Required Dependencies

Dependency	Purpose	Required?
`yt-dlp`	Fetch captions and download audio/video	✅ Always
`python3`	Parse VTT/SRT caption files	✅ Always
`curl`	Call OpenAI Whisper API	✅ For Whisper fallback
`ffmpeg`	Extract audio from TikTok/Instagram/X	⚠️ Non-YouTube only
`OPENAI_API_KEY`	Authenticate with OpenAI Whisper API	⚠️ Only if captions unavailable

Install binaries:

# yt-dlp
curl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o ~/bin/yt-dlp && chmod +x ~/bin/yt-dlp

# ffmpeg (Debian/Ubuntu)
sudo apt install ffmpeg

⚠️ Privacy Notice — OpenAI Audio Upload

When captions are unavailable (common for TikTok, Instagram, X), the script downloads the audio and uploads it to OpenAI's transcription API (https://api.openai.com/v1/audio/transcriptions). This means:

Audio content leaves your machine and is sent to OpenAI
Requires OPENAI_API_KEY to be set
If you don't want external transmission: don't set OPENAI_API_KEY, or use a local transcription model

YouTube videos almost always have captions and will not trigger an upload.

Script

~/.openclaw/skills/video-intel/scripts/video-intel.sh

Workflows

Get transcript

~/.openclaw/skills/video-intel/scripts/video-intel.sh transcript <url>

YouTube: uses built-in captions/auto-subs (fast, no audio download or external upload)
TikTok/Instagram/X: downloads audio → uploads to OpenAI Whisper for transcription
Preferred language: --lang pt for Portuguese

Get video info

~/.openclaw/skills/video-intel/scripts/video-intel.sh info <url>

List available caption tracks

~/.openclaw/skills/video-intel/scripts/video-intel.sh captions <url>

Download video

~/.openclaw/skills/video-intel/scripts/video-intel.sh download <url> [--format audio|720p|best]

After getting transcript

Summary: Summarize in 3-5 bullet points
Key quotes: Extract most notable quotes
Full summary: Write a paragraph summary with context
Translation: Translate to the user's language if different

Notes

YouTube auto-captions are usually available even without ffmpeg
TikTok/Instagram/X require ffmpeg for audio extraction
Large videos (>25MB audio) may hit OpenAI's file size limit — use --format audio to get a smaller mp3
Output cached in /tmp/video-intel/ by default

---name: video-intel-3description: Download videos and get transcripts, summaries, or metadata from YouTube, TikTok, Instagram, and X (Twitter). Use when the user shares a video URL and wants a transcript, summary, key points, quotes, or to download the video. Triggers on phrases like "transcript this video", "summarize this YouTube video", "what does this video say", "download this TikTok", "get captions from", or any video URL from youtube.com, youtu.be, tiktok.com, instagram.com, x.com, twitter.com. Requires: yt-dlp, python3, curl. Optional: ffmpeg (for TikTok/Instagram/X audio), OPENAI_API_KEY (Whisper fallback — uploads audio to OpenAI).---# video-intelDownloads videos and extracts transcripts using `yt-dlp` (captions) with OpenAI Whisper fallback.## Required Dependencies| Dependency | Purpose | Required? ||---|---|---|| `yt-dlp` | Fetch captions and download audio/video | ✅ Always || `python3` | Parse VTT/SRT caption files | ✅ Always || `curl` | Call OpenAI Whisper API | ✅ For Whisper fallback || `ffmpeg` | Extract audio from TikTok/Instagram/X | ⚠️ Non-YouTube only || `OPENAI_API_KEY` | Authenticate with OpenAI Whisper API | ⚠️ Only if captions unavailable |Install binaries:```bash# yt-dlpcurl -L https://github.com/yt-dlp/yt-dlp/releases/latest/download/yt-dlp -o ~/bin/yt-dlp && chmod +x ~/bin/yt-dlp# ffmpeg (Debian/Ubuntu)sudo apt install ffmpeg```## ⚠️ Privacy Notice — OpenAI Audio UploadWhen captions are unavailable (common for TikTok, Instagram, X), the script **downloads the audio and uploads it to OpenAI's transcription API** (`https://api.openai.com/v1/audio/transcriptions`). This means:- Audio content leaves your machine and is sent to OpenAI- Requires `OPENAI_API_KEY` to be set- If you don't want external transmission: don't set `OPENAI_API_KEY`, or use a local transcription modelYouTube videos almost always have captions and will **not** trigger an upload.## Script```~/.openclaw/skills/video-intel/scripts/video-intel.sh```## Workflows### Get transcript```bash~/.openclaw/skills/video-intel/scripts/video-intel.sh transcript <url>```- YouTube: uses built-in captions/auto-subs (fast, no audio download or external upload)- TikTok/Instagram/X: downloads audio → uploads to OpenAI Whisper for transcription- Preferred language: `--lang pt` for Portuguese### Get video info```bash~/.openclaw/skills/video-intel/scripts/video-intel.sh info <url>```### List available caption tracks```bash~/.openclaw/skills/video-intel/scripts/video-intel.sh captions <url>```### Download video```bash~/.openclaw/skills/video-intel/scripts/video-intel.sh download <url> [--format audio|720p|best]```## After getting transcript- **Summary**: Summarize in 3-5 bullet points- **Key quotes**: Extract most notable quotes- **Full summary**: Write a paragraph summary with context- **Translation**: Translate to the user's language if different## Notes- YouTube auto-captions are usually available even without ffmpeg- TikTok/Instagram/X require ffmpeg for audio extraction- Large videos (>25MB audio) may hit OpenAI's file size limit — use `--format audio` to get a smaller mp3- Output cached in `/tmp/video-intel/` by default

Frequently asked questions