Claude Social Magic Agent Plugin

What it is

One file: youtube-to-social.skill. It's a zip archive with a special extension that Cowork recognizes as installable. Inside are the brain (SKILL.md), the format library (29 viral video formats), the carousel composer, six bundled fonts, and two helper scripts.

You don't need design software, fonts, or any account. Once installed, you talk to it in plain English.

What you need

Install in Cowork

Three ways. Pick whichever feels easier.

EasiestDrag and drop

1. Locate the file

   Find youtube-to-social.skill in your Downloads folder.

2. Drag it into the Cowork chat window

   The file appears as a card with a Save skill button.

3. Click Save skill

   Cowork installs it into your skills directory and confirms.

Customize menu (alternative)

1. Open the Customize menu

   Click Customize in Cowork to open your skills and plugin settings.

2. Click Upload skill

   Pick youtube-to-social.skill from your file picker.

3. Confirm install

   Cowork installs the skill and lists it in your library.

Install in Claude Code CLI

If you're a developer using the Claude Code CLI instead of Cowork, the install is manual but quick.

1. Rename the file (if needed)

   Change youtube-to-social.skill to youtube-to-social.zip if your OS won't unzip .skill directly.

2. Unzip it

   You'll get a folder called youtube-to-social/ with SKILL.md inside.

3. Move it into your skills directory

   For a global install: ~/.claude/skills/youtube-to-social/. For a per-project install: your-project/.claude/skills/youtube-to-social/.

4. Restart Claude Code

   The skill loads automatically and is ready to use.

First-run setup

The first time you use the skill, it asks four quick questions. Your answers save to a config file inside the skill folder, and you won't be asked again.

That's it for basic setup. The first time you make a carousel, you'll be asked four more visual questions (aspect ratio, font, visual mode, aesthetic). Also asked once.

Generating your first piece of content

Paste a YouTube URL into chat and tell the skill what you want. Examples:

Or paste the URL on its own and the skill asks which output you want.

What happens next

The skill fetches the transcript, mines it for the strongest substance (claims, frameworks, specific examples, common mistakes), and asks you to choose an angle.

For scripts, you get 2 to 3 viral format options. Each one comes with a one-line explanation of how it would apply to this specific video. Pick the one that feels right, and the skill writes a 30 to 60 second talking-head script with on-screen text and B-roll cues.

For carousels, the skill derives the shape from the substance (a tier walk, a list of mistakes, a story arc) and writes 5 to 7 slides. You get individual PNGs for Instagram, a stitched PDF for LinkedIn, and a single grid preview.

Adding AI image generation

Carousels can run in two visual modes:

Mode	What it looks like	What it needs
Text-only	Clean designed slides on a colored gradient. Premium typographic look.	Nothing. Always works.
AI image + text overlay	A custom-generated illustration or photo per slide, with text overlaid in post.	An image-gen MCP connected to Claude.

Higgsfield is the recommended provider. Their MCP gives you photorealistic, illustrative, and stylized image generation, and it's built for marketing-grade output. Setup takes about two minutes.

If your image-gen MCP fails on a specific run (rate limits, content filter, model hiccup), tell the skill "text-only carousel" and it falls back to the always-works design for that one run.

Useful commands

Say this	What happens
redo setup	Re-asks the four basic onboarding questions.
change my voice	Updates just the voice preset.
redo carousel settings	Re-asks aspect ratio, font, visual mode, aesthetic.
you pick	The skill picks the sharpest-hook format for you instead of asking.
make a [format name] from this	Skips the menu and uses the format you named.
text-only carousel	Forces no-AI-image mode for this run.
use [aesthetic] for this one	Per-run aesthetic override without changing your default.

Bulk mode

Drop two or more YouTube URLs in a single message and the skill enters bulk mode. It auto-picks formats, processes everything in parallel, and delivers a batch with a summary table at the end. No per-video questions. Use this when you've got a list of videos to turn into content fast.

Troubleshooting

Privacy

Your config file (brand, audience, voice, CTA) stays on your machine inside the skill folder. The skill makes outbound calls only to YouTube to fetch a transcript and to your chosen image-gen MCP if you've connected one. No analytics, no telemetry, no tracking.