Watch
mathiaschu/watch
Watch a video from YouTube, Instagram, X/Twitter, Vimeo, TikTok or any of ~1800 yt-dlp sites (or a local path).
A skill your agent uses when the user shares a social video/post link or local video and wants it understood — an Instagram (instagram.com), TikTok (tiktok.com), YouTube or YouTube Shorts…
Install Analyze Social
The automated check flagged lines worth reading first. See the safety section below.
$ npx skills add ccplugins/awesome-claude-code-plugins --skill analyze-social -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install ccplugins/awesome-claude-code-plugins analyze-social --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/ccplugins/awesome-claude-code-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/social-vision/skills/analyze-social .claude/skills/analyze-social && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "analyze-social" agent skill from https://github.com/ccplugins/awesome-claude-code-plugins/tree/main/plugins/social-vision/skills/analyze-social into .claude/skills/analyze-social/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "analyze-social", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/ccplugins/awesome-claude-code-plugins/tree/main/plugins/social-vision/skills/analyze-socialType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add ccplugins/awesome-claude-code-plugins --skill analyze-social -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install ccplugins/awesome-claude-code-plugins analyze-social --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ccplugins/awesome-claude-code-plugins.git skills-src && mkdir -p .agents/skills && cp -r skills-src/plugins/social-vision/skills/analyze-social .agents/skills/analyze-social && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "analyze-social" agent skill from https://github.com/ccplugins/awesome-claude-code-plugins/tree/main/plugins/social-vision/skills/analyze-social into .agents/skills/analyze-social/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "analyze-social", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ccplugins/awesome-claude-code-plugins --skill analyze-social -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install ccplugins/awesome-claude-code-plugins analyze-social --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ccplugins/awesome-claude-code-plugins.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/plugins/social-vision/skills/analyze-social .cursor/skills/analyze-social && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "analyze-social" agent skill from https://github.com/ccplugins/awesome-claude-code-plugins/tree/main/plugins/social-vision/skills/analyze-social into .cursor/skills/analyze-social/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "analyze-social", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/ccplugins/awesome-claude-code-plugins.git --path plugins/social-vision/skills/analyze-social--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add ccplugins/awesome-claude-code-plugins --skill analyze-social -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install ccplugins/awesome-claude-code-plugins analyze-social --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ccplugins/awesome-claude-code-plugins.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/plugins/social-vision/skills/analyze-social .gemini/skills/analyze-social && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "analyze-social" agent skill from https://github.com/ccplugins/awesome-claude-code-plugins/tree/main/plugins/social-vision/skills/analyze-social into .gemini/skills/analyze-social/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "analyze-social", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install ccplugins/awesome-claude-code-plugins analyze-socialInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add ccplugins/awesome-claude-code-plugins --skill analyze-social -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/ccplugins/awesome-claude-code-plugins.git skills-src && mkdir -p .github/skills && cp -r skills-src/plugins/social-vision/skills/analyze-social .github/skills/analyze-social && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "analyze-social" agent skill from https://github.com/ccplugins/awesome-claude-code-plugins/tree/main/plugins/social-vision/skills/analyze-social into .github/skills/analyze-social/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "analyze-social", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add ccplugins/awesome-claude-code-plugins --skill analyze-social -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install ccplugins/awesome-claude-code-plugins analyze-social --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/ccplugins/awesome-claude-code-plugins.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/plugins/social-vision/skills/analyze-social .opencode/skills/analyze-social && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "analyze-social" agent skill from https://github.com/ccplugins/awesome-claude-code-plugins/tree/main/plugins/social-vision/skills/analyze-social into .opencode/skills/analyze-social/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "analyze-social", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
analyze-social- GitHub stars
- 967
- Token cost
- ~1.1k tokens
- SKILL.md length
- 541 words
- Files
- 1
- Skills in repo
- 68
- Repo updated
- First seen
- Licence
- Apache-2.0
At a glance
A skill your agent uses when the user shares a social video/post link or local video and wants it understood — an Instagram (instagram.com), TikTok (tiktok.com), YouTube or YouTube Shorts…
- Works in 4 steps: Run the pipeline (use the Bash tool) → Read the printed result block. It ends… → Load the bundle. Read manifest.json (the… → …
- The user shares a social video/post link
- SKILL.md covers Overview, When to use, Workflow and Output template (be thorough —…, plus 1 more section
- Calls python3
What it does
Analyze Social is an agent skill from ccplugins/awesome-claude-code-plugins. Use when the user shares a social video/post link or local video and wants it understood — an Instagram (instagram.com), TikTok (tiktok.com), YouTube or YouTube Shorts (youtube.com/youtu.be), or X/Twitter (x.com/twitter.com) URL, or a local .mp4/.mov file, OR when they say "analyze/watch/transcribe this video/reel/post." Downloads it, transcribes the audio, extracts frames Claude can see, and produces a thorough breakdown.
Its SKILL.md is about 1.1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Media & Creative, covering Transcription and Video scripts and shorts. It works with X (Twitter), Instagram, TikTok and YouTube. The repository describes itself as: Awesome Claude Code plugins — a curated list of slash commands, subagents, MCP servers, and hooks for Claude Code. The licence is Apache-2.0.
When your agent uses it
- The user shares a social video/post link
- Local video and wants it understood — an Instagram (instagram.com)
- TikTok (tiktok.com)
- YouTube Shorts (youtube.com/youtu.be)
Example prompts
- “analyze/watch/transcribe this video/reel/post.”
- “/analyze-social”
Requirements
- Python 3
Workflow steps
4 steps, taken from the first numbered list in SKILL.md.
- Run the pipeline (use the Bash tool)
- Read the printed result block. It ends with ERROR_CODE, BUNDLE, TYPE, FRAMES, TRANSCRIPT. Handle the error code
- Load the bundle. Read manifest.json (the contract) from the BUNDLE path, then
- Write the analysis using the template below.
What it can do on your machine
Read from SKILL.md and the folder at commit 5bd4f16. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
Shell commands in SKILL.md call:
python3
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Analyze Social loads about 1.1k tokens when it runs. Until then it costs about 110 tokens; SKILL.md has 541 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check: warnings
The automated check found patterns that need a careful read before installing.
- WarningMentions a credentials file (SSH keys, cloud or package-manager tokens)SKILL.md:31
are you logged into that platform on? (chrome / firefox / safari / edge / brave)"* then re-run with `--cookies-from-bro
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from ccplugins/awesome-claude-code-plugins at commit 5bd4f16, republished under its Apache-2.0 licence (© ccplugins). 541 words, ~1,128 tokens.
Download SKILL.mdSave it as
.claude/skills/analyze-social/SKILL.md (or your agent's skills folder).- name
- analyze-social
- description
- Use when the user shares a social video/post link or local video and wants it understood — an Instagram (instagram.com), TikTok (tiktok.com), YouTube or YouTube Shorts (youtube.com/youtu.be), or X/Twitter (x.com/twitter.com) URL, or a local .mp4/.mov file, OR when they say "analyze/watch/transcribe this video/reel/post." Downloads it, transcribes the audio, extracts frames Claude can see, and produces a thorough breakdown.
Analyze Social (watch a video/post for the user)
Overview
Turns a social link (or local video) into material you can actually read: sampled frames you view with native vision, a full transcript, and the post's caption. Then you write a thorough breakdown. A bundled cross-platform Python pipeline does the fetching/transcribing; you do the understanding.
When to use
- The user pastes an Instagram / TikTok / YouTube / YouTube Shorts / X (Twitter) URL.
- The user gives a local video file path.
- The user asks to watch / analyze / transcribe / summarize a video, reel, short, or post.
Workflow
Run the pipeline (use the Bash tool):
bash python3 "${CLAUDE_PLUGIN_ROOT}/scripts/analyze.py" "<URL or local file path>"- The first run auto-installs its tools (yt-dlp, gallery-dl, a Whisper engine, and ffmpeg). Tell the user this one-time setup can take a few minutes and may ask them to approve installs. Subsequent runs are fast.
- Useful flags:
--no-transcribe(frames + caption only, faster),--target-frames N,--lang <code>.
Read the printed result block. It ends with
ERROR_CODE,BUNDLE,TYPE,FRAMES,TRANSCRIPT. Handle the error code:NEEDS_LOGIN→ the content is private/login-walled. Ask the user: "Which browser are you logged into that platform on? (chrome / firefox / safari / edge / brave)" then re-run with--cookies-from-browser <browser>. Only do this when the user has opted in — reading browser cookies is sensitive and may trigger a keychain prompt.RATE_LIMITED→ tell them to wait a few minutes, or retry with--cookies-from-browserto use their logged-in session.SETUP_FAILED→ show theMESSAGE(usually a one-line command to install ffmpeg) and offer to run it.none→ success, continue.
Load the bundle. Read
manifest.json(the contract) from theBUNDLEpath, then:- Read
meta.txt(caption + metadata) and, if present,transcript.txt. - View the frames with the Read tool — a spread across the timeline (first, several middle, last) for video; all slides in order for an image carousel. You read on-screen text/captions directly from the frames; no separate OCR.
- Read
Write the analysis using the template below.
Show full SKILL.md (228 more words)Show less
Output template (be thorough — a faithful record, not a teaser)
- Header — platform · creator handle/name · date · type · duration · engagement (views/likes/comments if present) · URL.
- TL;DR — 1–2 sentences: what this is.
- Full transcript — verbatim, everything. The complete spoken audio word-for-word, with timestamps from
transcript.srt. Do not summarize or drop lines. The only allowed cleanup is collapsing obvious hallucinated repeat-lines (e.g. "Okay. Okay. Okay."), never real speech. If there's no audio/speech, say so. - On-screen text & visuals (timeline) — everything visible across the frames: text overlays/captions transcribed, graphics, charts/numbers, b-roll, setting, what the creator is doing, products/profiles shown. For carousels: every slide in order, with its full text + a description of its image.
- Caption / description — verbatim — exactly as posted, including hashtags, @mentions, links.
- Beat-by-beat structure (video) — how it's built, with timestamps: hook → point 1 → … → CTA.
- Takeaway & intent — core message, what it's actually sharing, the goal (educate / sell / lead-gen / entertain), and any explicit CTA.
- Notable details — names, tools, stats, claims, prices, links, anything quotable.
Adapt per type: a plain text tweet skips transcript/frames; an image carousel leans on the visuals section.
Then stay open for follow-ups ("just the hook," "list every stat," "summarize in 3 bullets," etc.).
Notes
- Everything runs locally; nothing is uploaded. Browser cookies are read only when the user opts in for login-walled content.
- TikTok and YouTube are usually public (no login). Instagram posts/carousels and many X posts require being logged in.
© ccplugins, Apache-2.0. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in plugins/social-vision/skills/analyze-social of ccplugins/awesome-claude-code-plugins.
Open the folder on GitHubat commit 5bd4f16
Compare with similar skills
Analyze Social next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Analyze Social this skillccplugins/awesome-claude-code-plugins | 967 | — | ~1.1k | Automated safety check: Warn | Apache-2.0 | |
| Watchmathiaschu/watch | 141 | — | ~4k | Automated safety check: Warn | MIT | |
| AI Social Media ContentNeverSight/learn-skills.dev | 216 | 1 repos | ~1.8k | Automated safety check: Pass | None | |
| Outlier Post FinderScrapeCreators/social-media-research-skills | 3.3k | — | ~1.5k | Automated safety check: Notes | MIT | |
| WatchTheCraigHewitt/skills | 156 | — | ~1.6k | Automated safety check: Notes | MIT | |
| Cross Platform ReformatterOotto-AI/claude-content-skills | 101 | — | ~449 | Automated safety check: Pass | MIT |
Similar skills
AI Social Media Content
NeverSight/learn-skills.dev
Create AI-powered social media content for TikTok, Instagram, YouTube, Twitter/X.
Outlier Post Finder
ScrapeCreators/social-media-research-skills
A skill your agent uses when the user wants to find posts, videos, reels, shorts, tweets, or social content that overperformed versus a creator, brand, or competitor baseline.
Watch
TheCraigHewitt/skills
When the user wants to read, transcribe, summarize, or research a video — YouTube link, podcast clip, Loom, TikTok, X/Twitter video, local file, or any URL yt-dlp supports.
Cross Platform Reformatter
Ootto-AI/claude-content-skills
Reshapes one Instagram reel into a TikTok and a YouTube Short — adjusting hook, length and captions per platform.
Ffmpeg Skill
kajisho5/ffmpeg-skill
Edit video and audio with local FFmpeg from natural-language requests: cut, trim, join, resize/reframe (9:16, 1:1), speed change, captions and subtitles (SRT/ASS, animated, karaoke), logos and text…
More from ccplugins/awesome-claude-code-plugins
All 68 skills in this repoAI Meeting
ccplugins/awesome-claude-code-plugins
Run structured AI meetings for plans, product ideas, technical designs, business decisions, feature proposals, and strategy choices.
Fastapi App
ccplugins/awesome-claude-code-plugins
Bootstrap a new FastAPI backend with async SQLAlchemy 2.0, asyncpg, Alembic, Pydantic v2, and no deprecated APIs.
Flutter App
ccplugins/awesome-claude-code-plugins
Bootstrap a new Flutter mobile app with clean architecture, Riverpod, FVM-pinned SDK, current packages, and no deprecated APIs.
Nextjs App
ccplugins/awesome-claude-code-plugins
Bootstrap a new Next.js (App Router, TypeScript) web app with current packages and no deprecated APIs.
Dev Report
ccplugins/awesome-claude-code-plugins
Write up a coding session for a non-technical stakeholder — the context, what was built, and the engineering reasoning behind it — the way a senior engineer briefs a product manager who does not…
Difesa Attacchi
ccplugins/awesome-claude-code-plugins
Aggiunge a un sito/app un agente di difesa che rileva e blocca richieste malevole (SQL injection, XSS, path traversal, brute force, bot) con rate limiting, blocklist IP e modalità lockdown che…
Related
Works with
Categories
Questions about Analyze Social
What does Analyze Social do?
A skill your agent uses when the user shares a social video/post link or local video and wants it understood — an Instagram (instagram.com), TikTok (tiktok.com), YouTube or YouTube Shorts…. Analyze Social is an agent skill from ccplugins/awesome-claude-code-plugins." Downloads it, transcribes the audio, extracts frames Claude can see, and produces a thorough breakdown.
When should I use Analyze Social?
Analyze Social fits situations like: the user shares a social video/post link; local video and wants it understood — an Instagram (instagram.com); tikTok (tiktok.com); youTube Shorts (youtube.com/youtu.be).
How do I install Analyze Social in Claude Code?
Run `npx skills add ccplugins/awesome-claude-code-plugins --skill analyze-social -a claude-code`. Or copy the skill folder (plugins/social-vision/skills/analyze-social in ccplugins/awesome-claude-code-plugins) into .claude/skills/analyze-social in your project. Claude Code loads it when a task matches its description.
How do I install Analyze Social in Codex?
Run `npx skills add ccplugins/awesome-claude-code-plugins --skill analyze-social -a codex`. Or copy the skill folder (plugins/social-vision/skills/analyze-social in ccplugins/awesome-claude-code-plugins) into .agents/skills/analyze-social in your project. Codex loads it when a task matches its description.
Can I use Analyze Social in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ccplugins/awesome-claude-code-plugins --skill analyze-social -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/analyze-social, .gemini/skills/analyze-social, .github/skills/analyze-social and .opencode/skills/analyze-social in your project.
What does Analyze Social need to run?
Going by SKILL.md and its folder, Analyze Social needs the command-line tools its instructions call (python3). Our summary lists: Python 3.
Does Analyze Social access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Analyze Social safe to install?
Our automated static check of SKILL.md flagged 1 warning(s): mentions a credentials file (ssh keys, cloud or package-manager tokens). Read the flagged lines before installing; the check is not a guarantee either way.
What licence does Analyze Social use?
Analyze Social is published under the Apache-2.0 licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Analyze Social use?
About 1.1k tokens (SKILL.md is roughly 4.5k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Analyze Social?
Skills that share tags, products or a category with Analyze Social: Watch (mathiaschu/watch, 141 stars), AI Social Media Content (NeverSight/learn-skills.dev, 216 stars), Outlier Post Finder (ScrapeCreators/social-media-research-skills, 3.3k stars) and Watch (TheCraigHewitt/skills, 156 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Analyze Social?
ccplugins (a GitHub organization) maintains it in ccplugins/awesome-claude-code-plugins, which has 967 GitHub stars. The repository holds 68 skills in this directory. The repository was last updated on August 12, 2026.
Source: ccplugins/awesome-claude-code-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.