Add social-vision plugin (Marketing Growth)

.claude-plugin/marketplace.json

@@ -5,7 +5,7 @@
     "email": "support@claudecodeplugins.dev"
   },
   "metadata": {
-    "description": "Awesome Claude Code plugins — a curated list of slash commands, subagents, MCP servers, and hooks for Claude Code",
+    "description": "Awesome Claude Code plugins \u2014 a curated list of slash commands, subagents, MCP servers, and hooks for Claude Code",
     "version": "0.0.1",
     "homepage": "https://claudecodeplugins.dev"
   },
@@ -73,7 +73,7 @@
     {
       "name": "ultrathink",
       "source": "./plugins/ultrathink",
-      "description": "Use /ultrathink <TASK_DESCRIPTION> to launch a Coordinator Agent that directs four specialist sub-agents—Architect, Research, Coder, and Tester—to analyze, design, implement, and validate your coding task. The process breaks the task into clear steps, gathers insights, and synthesizes a cohesive solution with actionable outputs. Relevant files can be referenced ad-hoc using @ filename syntax.",
+      "description": "Use /ultrathink <TASK_DESCRIPTION> to launch a Coordinator Agent that directs four specialist sub-agents\u2014Architect, Research, Coder, and Tester\u2014to analyze, design, implement, and validate your coding task. The process breaks the task into clear steps, gathers insights, and synthesizes a cohesive solution with actionable outputs. Relevant files can be referenced ad-hoc using @ filename syntax.",
       "version": "1.0.0",
       "author": {
         "name": "Jeronim Morina"
@@ -847,7 +847,7 @@
       "description": "Use this agent when setting up CI/CD pipelines, configuring Docker containers, deploying applications to cloud platforms, setting up Kubernetes clusters, implementing infrastructure as code, or automating deployment workflows. Examples: <example>Context: User is setting up a new project and needs deployment automation. user: \"I've built a FastAPI application and need to deploy it to production with proper CI/CD\" assistant: \"I'll use the deployment-engineer agent to set up a complete deployment pipeline with Docker, GitHub Actions, and production-ready configurations.\"</example> <example>Context: User mentions containerization or deployment issues. user: \"Our deployment process is manual and error-prone. We need to automate it.\" assistant: \"Let me use the deployment-engineer agent to design an automated CI/CD pipeline that eliminates manual steps and ensures reliable deployments.\"</example>",
       "version": "1.0.0",
       "author": {
-        "name": "Jure Šunić"
+        "name": "Jure \u0160uni\u0107"
       },
       "category": "Automation DevOps",
       "homepage": "https://github.com/ccplugins/awesome-claude-code-plugins/tree/main/plugins/deployment-engineer",
@@ -1141,7 +1141,7 @@
       "description": "Use this agent when you need to design, build, or validate n8n automation workflows. This agent specializes in creating efficient n8n workflows using proper validation techniques and MCP tools integration.\\n\\nExamples:\\n- <example>\\n  Context: User wants to create a Slack notification workflow when a new GitHub issue is created.\\n  user: \"I need to create an n8n workflow that sends a Slack message whenever a new GitHub issue is opened\"\\n  assistant: \"I'll use the n8n-workflow-builder agent to design and build this GitHub-to-Slack automation workflow with proper validation.\"\\n  <commentary>\\n  The user needs n8n workflow creation, so use the n8n-workflow-builder agent to handle the complete workflow design, validation, and deployment process.\\n  </commentary>\\n</example>\\n- <example>\\n  Context: User has an existing n8n workflow that needs debugging and optimization.\\n  user: \"My n8n workflow keeps failing at the HTTP Request node, can you help me fix it?\"\\n  assistant: \"I'll use the n8n-workflow-builder agent to analyze and debug your workflow, focusing on the HTTP Request node configuration.\"\\n  <commentary>\\n  Since this involves n8n workflow troubleshooting and validation, use the n8n-workflow-builder agent to diagnose and fix the issue.\\n  </commentary>\\n</example>\\n- <example>\\n  Context: User wants to understand n8n best practices and available nodes for a specific use case.\\n  user: \"What are the best n8n nodes for processing CSV data and sending email reports?\"\\n  assistant: \"I'll use the n8n-workflow-builder agent to explore the available nodes and recommend the best approach for CSV processing and email automation.\"\\n  <commentary>\\n  This requires n8n expertise and node discovery, so use the n8n-workflow-builder agent to provide comprehensive guidance.\\n  </commentary>\\n</example>",
       "version": "1.0.0",
       "author": {
-        "name": "Jure Šunić"
+        "name": "Jure \u0160uni\u0107"
       },
       "category": "Automation DevOps",
       "homepage": "https://github.com/ccplugins/awesome-claude-code-plugins/tree/main/plugins/n8n-workflow-builder",
@@ -1197,7 +1197,7 @@
       "description": "Use this agent when you need to create comprehensive Product Requirements Documents (PRDs) that combine business strategy, technical architecture, and user research. Examples: <example>Context: The user needs to create a PRD for a new feature or product launch. user: \"I need to create a PRD for our new user authentication system that will support SSO and multi-factor authentication\" assistant: \"I'll use the prd-specialist agent to create a comprehensive PRD that covers the strategic foundation, technical requirements, and implementation blueprint for your authentication system.\"</example> <example>Context: The user is planning a major product initiative and needs strategic documentation. user: \"We're launching a mobile app for our e-commerce platform and need a detailed PRD to guide development\" assistant: \"Let me engage the prd-specialist agent to develop a thorough PRD that includes market analysis, user research integration, technical architecture, and implementation roadmap for your mobile app initiative.\"</example>",
       "version": "1.0.0",
       "author": {
-        "name": "Jure Šunić"
+        "name": "Jure \u0160uni\u0107"
       },
       "category": "Project & Product Management",
       "homepage": "https://github.com/ccplugins/awesome-claude-code-plugins/tree/main/plugins/prd-specialist",
@@ -1281,7 +1281,7 @@
       "description": "Use this agent when working with Python code that requires advanced features, performance optimization, or comprehensive refactoring. Examples: <example>Context: User needs to optimize a slow Python function that processes large datasets. user: \"This function is taking too long to process our data, can you help optimize it?\" assistant: \"I'll use the python-expert agent to analyze and optimize your Python code with advanced techniques and performance profiling.\"</example> <example>Context: User wants to implement async/await patterns in their existing synchronous Python code. user: \"I need to convert this synchronous code to use async/await for better performance\" assistant: \"Let me use the python-expert agent to refactor your code with proper async/await patterns and concurrent programming techniques.\"</example> <example>Context: User needs help implementing complex Python design patterns. user: \"I want to implement a factory pattern with decorators for my API endpoints\" assistant: \"I'll use the python-expert agent to implement advanced Python patterns with decorators and proper design principles.\"</example>",
       "version": "1.0.0",
       "author": {
-        "name": "Jure Šunić"
+        "name": "Jure \u0160uni\u0107"
       },
       "category": "Development Engineering",
       "homepage": "https://github.com/ccplugins/awesome-claude-code-plugins/tree/main/plugins/python-expert",
@@ -1670,6 +1670,26 @@
         "security",
         "compliance"
       ]
+    },
+    {
+      "name": "social-vision",
+      "source": "./plugins/social-vision",
+      "description": "Paste an Instagram, TikTok, YouTube (Shorts), or X/Twitter link and Claude watches it for you \u2014 transcribes the audio, reads on-screen text and visuals, and explains what it's about. Local and cross-platform.",
+      "version": "1.0.0",
+      "author": {
+        "name": "Shivang Trivedi",
+        "url": "https://github.com/Shivang0"
+      },
+      "category": "Marketing Growth",
+      "homepage": "https://github.com/ccplugins/awesome-claude-code-plugins/tree/main/plugins/social-vision",
+      "keywords": [
+        "video",
+        "instagram",
+        "tiktok",
+        "youtube",
+        "twitter",
+        "transcription"
+      ]
     }
   ]
-}
+}

README.md

@@ -165,6 +165,7 @@ Install or disable them dynamically with the `/plugin` command — enabling you
 - [growth-hacker](./plugins/growth-hacker)
 - [instagram-curator](./plugins/instagram-curator)
 - [reddit-community-builder](./plugins/reddit-community-builder)
+- [social-vision](./plugins/social-vision)
 - [tiktok-strategist](./plugins/tiktok-strategist)
 - [twitter-engager](./plugins/twitter-engager)
 
@@ -212,4 +213,4 @@ Example:
 ## Contributing
 
 Contributions are welcome!
- You can add your favorite plugins, share best practices, or submit your own marketplace.
+ You can add your favorite plugins, share best practices, or submit your own marketplace.

plugins/social-vision/.claude-plugin/plugin.json

@@ -0,0 +1,21 @@
+{
+  "name": "social-vision",
+  "version": "1.0.0",
+  "description": "Paste an Instagram, TikTok, YouTube (Shorts), or X/Twitter link and Claude watches it for you — transcribes the audio, reads the on-screen text and visuals, and explains what it's actually about. Runs locally and cross-platform.",
+  "author": {
+    "name": "Shivang Trivedi"
+  },
+  "homepage": "https://github.com/Shivang0/social-vision",
+  "repository": "https://github.com/Shivang0/social-vision",
+  "license": "MIT",
+  "keywords": [
+    "video",
+    "instagram",
+    "tiktok",
+    "youtube",
+    "twitter",
+    "transcription",
+    "whisper",
+    "vision"
+  ]
+}

plugins/social-vision/.gitignore

@@ -0,0 +1,3 @@
+__pycache__/
+*.pyc
+.DS_Store

plugins/social-vision/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Shivang Trivedi
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

plugins/social-vision/README.md

@@ -0,0 +1,147 @@
+# 🎬 social-vision
+
+**Paste a social media link. Claude watches the video for you.**
+
+social-vision is a Claude Code plugin that lets you drop in an Instagram, TikTok,
+YouTube, or X (Twitter) link — and Claude will *actually understand it*. It
+listens to the audio, reads the text and graphics on screen, reads the caption,
+and then tells you what the video is really about.
+
+No copy-pasting transcripts. No "I can't watch videos." Just paste and ask.
+
+---
+
+## What it can do
+
+- 🎧 **Transcribe the audio** — word for word, with timestamps.
+- 👀 **See what's on screen** — on-screen captions, charts, graphics, products, the setting — Claude looks at the actual frames.
+- 📝 **Read the caption** — including hashtags, mentions, and links.
+- 🧠 **Explain it** — a full breakdown: what's said, what's shown, and what it's trying to get you to do.
+- 🖼️ **Handle photo posts too** — Instagram carousels and X image posts are read slide by slide.
+
+### Supported links
+
+| Platform | Reels / Videos / Shorts | Photo posts & carousels |
+|----------|:----------------------:|:-----------------------:|
+| Instagram | ✅ | ✅ |
+| TikTok | ✅ | — |
+| YouTube + Shorts | ✅ | — |
+| X / Twitter | ✅ | ✅ |
+| A video file on your computer | ✅ | — |
+
+---
+
+## Install
+
+In Claude Code:
+
+```
+/plugin marketplace add Shivang0/social-vision
+/plugin install social-vision@social-vision
+/reload-plugins
+```
+
+That's it. No keys, no accounts, no sign-ups.
+
+> Prefer to run it from a local checkout? Clone the repo and
+> `/plugin marketplace add /path/to/social-vision` instead.
+
+---
+
+## Use it
+
+Just paste a link into Claude Code:
+
+> analyze https://www.instagram.com/reel/XXXXXXXX/
+
+or use the command:
+
+> /analyze https://www.tiktok.com/@someone/video/123456789
+
+Claude takes care of the rest and gives you the full breakdown. You can then ask
+follow-ups like *"just give me the hook,"* *"list every stat it mentioned,"* or
+*"summarize it in 3 bullets."*
+
+### Example
+
+**You:**
+
+> /analyze https://www.instagram.com/reel/XXXXXXXX/
+
+**social-vision** (after ~30–60s):
+
+> **Reel by @creator — "How the new LinkedIn algorithm works"**
+> Instagram · 99s · 1,975 likes
+>
+> **TL;DR** — A talking-head reel arguing likes no longer matter; saves, comments, and dwell time now drive reach.
+>
+> **Full transcript (verbatim, with timestamps)**
+> `[00:00]` I grew my LinkedIn followers to over 210,000 by using the new algorithm to my advantage…
+> `[00:16]` LinkedIn replaced its engagement-based system with a 150-billion-parameter model…
+> *…complete, nothing dropped…*
+>
+> **On screen** — creator at a podcast mic; text overlays "saves 5×", "comments 15×"; a ranked chart: Text 2–4% ‹ Video 5.6% ‹ Carousel 6.6%.
+>
+> **Caption** — "LinkedIn's new algorithm doesn't care how many likes you get… comment PLAYBOOK 👇 #linkedintips"
+>
+> **Takeaway** — Educational hook + lead magnet: optimize for saves / long comments / carousels; "comment PLAYBOOK" funnels to a paid program.
+
+Then keep asking: *"list every stat,"* *"just the hook,"* *"summarize in 3 bullets,"* *"what's the call to action?"*
+
+> Works the same for a **TikTok**, **YouTube Short**, **X post**, or a local `.mp4`. Image carousels come back slide-by-slide.
+
+### First run takes a few minutes ⏳
+
+The very first time you use it, social-vision quietly sets itself up — it
+installs the small tools it needs to download and transcribe videos. You may be
+asked to approve an install or two. **This happens once.** Every run after that
+is fast.
+
+It automatically picks the best transcription engine for your computer (Apple
+Silicon Macs, NVIDIA GPUs, and regular laptops are all handled), and everything
+runs **on your own machine** — your videos are never uploaded anywhere.
+
+---
+
+## 🔑 Private or login-only content
+
+Some posts can only be viewed when you're logged in — most **Instagram photo
+posts and carousels**, private accounts, and many **X/Twitter posts**.
+
+To analyze those, **stay logged into that platform in your normal web browser**
+(Chrome, Firefox, Safari, Edge, or Brave). When Claude hits a login wall, it will
+ask which browser you use, then borrow your existing login to fetch the post.
+
+- It only does this **when you say yes** — it never touches your browser otherwise.
+- On a Mac, your system may pop up a keychain prompt to allow it; that's normal.
+- TikTok and YouTube are usually public, so they work without any of this.
+
+---
+
+## 🔒 Privacy
+
+- Everything runs **locally on your computer**. Videos and audio are not sent to any third party.
+- Your browser login is only used when you explicitly approve it for a private post, and it stays on your machine.
+- Downloaded videos and results are saved under `~/.social-vision/` so you can find or delete them anytime.
+
+---
+
+## Troubleshooting
+
+| Problem | Fix |
+|---------|-----|
+| "ffmpeg could not be installed" | Run the one-line command Claude shows you (e.g. `brew install ffmpeg` on Mac, `winget install Gyan.FFmpeg` on Windows, `sudo apt install ffmpeg` on Linux). |
+| A link suddenly stops downloading | Platforms change often. Ask Claude to update the downloader — it can refresh the tool automatically. |
+| "Needs login" on a public-looking post | Tell Claude which browser you're logged into; it'll retry using your session. |
+| Transcript looks repetitive/empty | The video probably has little or no speech (music only). The on-screen visuals still get analyzed. |
+
+---
+
+## Notes
+
+- This tool downloads content for your own personal analysis. Respect each
+  platform's terms of service and the rights of content creators.
+
+## License
+
+MIT — see [LICENSE](LICENSE).

plugins/social-vision/commands/analyze.md

@@ -0,0 +1,15 @@
+---
+description: Watch & analyze a social video/post — Instagram, TikTok, YouTube (Shorts), or X/Twitter URL, or a local video file
+argument-hint: <url-or-file>
+---
+
+Analyze the social video/post at: $ARGUMENTS
+
+Follow the `analyze-social` skill workflow:
+
+1. Run `python3 "${CLAUDE_PLUGIN_ROOT}/scripts/analyze.py" "$ARGUMENTS"` (warn the user the first run auto-installs tools and may take a few minutes).
+2. Handle any `ERROR_CODE` (e.g. `NEEDS_LOGIN` → ask which browser they're logged into, re-run with `--cookies-from-browser <browser>`).
+3. Read `manifest.json`, `meta.txt`, `transcript.txt`, and view the frames from the bundle.
+4. Produce the thorough breakdown defined in the skill's output template (header, TL;DR, full verbatim transcript with timestamps, on-screen text & visuals, verbatim caption, beat-by-beat, takeaway & intent, notable details), then stay open for follow-ups.
+
+If `$ARGUMENTS` is empty, ask the user for a link or file path.