Write algorithm-optimized captions/descriptions for social media posts and reels.

MITAuto-check: notesWriting & Content

Install Social Captions

skills CLI
$ npx skills add rediumvex/social-media-caption-generator-claude --skill social-captions -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install rediumvex/social-media-caption-generator-claude social-captions --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
social-captions
GitHub stars
131
Token cost
~2.7k tokens
SKILL.md length
1,259 words
Files
3
Skills in repo
1
Repo updated
First seen
Licence
MIT

At a glance

Write algorithm-optimized captions/descriptions for social media posts and reels.

  • Works in 3 steps: Analyze the Input → Generate Captions for ALL Platforms → End with
  • Asked to write a caption
  • SKILL.md covers WORKFLOW, 1. INSTAGRAM REELS, 2. INSTAGRAM CAROUSEL and 3. TIKTOK, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Social Captions is an agent skill from rediumvex/social-media-caption-generator-claude. Write algorithm-optimized captions/descriptions for social media posts and reels. Supports Instagram (Reels, Feed, Carousel), TikTok, Threads, Facebook, and YouTube Shorts. The user sends material (text, image, script, competitor post, screenshot) and gets ready-to-use captions for ALL platforms at once, in English. Use when asked to "write a caption", "write a description", "caption for instagram", "описание к посту", "подпись для рилса", "описание для тикток", "caption for reels", "social media post", or any…

Its SKILL.md is about 2.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 2 other files (for example `README.md`).

It sits in Writing & Content, covering Social media posts and Video scripts and shorts. It works with Instagram and TikTok. The repository describes itself as: Social media caption generator as a Claude skill — turn any text, script, or screenshot into ready-to-post captions for Instagram Reels, Carousel, TikTok, Threads, Facebook… The licence is MIT.

When your agent uses it

  • Asked to write a caption
  • Write a description
  • Caption for instagram
  • Описание к посту

Example prompts

  • “write a caption”
  • “write a description”
  • “caption for instagram”
  • “/social-captions”

Requirements

  • Pre-approved tools (allowed-tools): Bash, Read, Write, Edit, Glob, Grep

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Analyze the Input
  2. Generate Captions for ALL Platforms
  3. End with

What it can do on your machine

Read from SKILL.md and the folder at commit 37cad54. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves these tools, so the agent can use them without asking each time:

    • Bash
    • Read
    • Write
    • Edit
    • Glob
    • Grep

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md.

    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

Social Captions loads about 2.7k tokens when it runs. Until then it costs about 181 tokens; SKILL.md has 1,259 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~181
When it runs · the whole SKILL.md, loaded when a task matches
~2.7k

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: notes

The automated check noted patterns worth knowing about, such as sudo or a known installer.

  • NotePre-approves every shell command (allowed-tools: Bash)SKILL.md
    allowed-tools: Bash, Read, Write, Edit, Glob, Grep

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 rediumvex/social-media-caption-generator-claude at commit 37cad54, republished under its MIT licence (© rediumvex). 1,259 words, ~2,731 tokens.

Download SKILL.mdSave it as .claude/skills/social-captions/SKILL.md (or your agent's skills folder). This skill also uses 2 other files; get the full folder from GitHub.
name
social-captions
description
Write algorithm-optimized captions/descriptions for social media posts and reels. Supports Instagram (Reels, Feed, Carousel), TikTok, Threads, Facebook, and YouTube Shorts. The user sends material (text, image, script, competitor post, screenshot) and gets ready-to-use captions for ALL platforms at once, in English. Use when asked to "write a caption", "write a description", "caption for instagram", "описание к посту", "подпись для рилса", "описание для тикток", "caption for reels", "social media post", or any caption/description writing task. Also triggers when user sends an image, screenshot, or text and says something like "сделай описание", "напиши подпись", "caption this", "описание для этого".
allowed-tools
Bash, Read, Write, Edit, Glob, Grep
version
2.0.0

/social-captions — Algorithm-Optimized Social Media Captions (v2)

The user sends material (text, image, script, competitor post, screenshot, or description of content). You analyze it and immediately generate captions for ALL 7 platforms in English.

No questions. No menus. Just analyze and deliver.

WORKFLOW

STEP 1: Analyze the Input

Read/view whatever the user sent:

  • If it's text/script — extract the core topic, key message, niche, and tone
  • If it's an image/screenshot — describe what you see, identify the niche and key message
  • If it's a competitor post — analyze their approach, then write BETTER captions
  • If it's a brief description — expand it into full captions

Write a short (2-3 sentence) analysis:

**Topic:** [what this is about]
**Niche:** [industry/category]
**Key message:** [the core idea to communicate]
STEP 2: Generate Captions for ALL Platforms

Generate captions for all 7 formats below. Each caption must use a DIFFERENT formula. All captions in English only.

Output in this exact format:


1. INSTAGRAM REELS

[Ready to copy-paste caption text]

[3-5 hashtags]

Formula: [name] | Hook: [type] | CTA: [type] | Optimizes for: [signal]


[Ready to copy-paste caption text]

[3-5 hashtags]

Formula: [name] | Hook: [type] | CTA: [type] | Optimizes for: [signal]


3. TIKTOK

[Ready to copy-paste caption text]

[3-5 hashtags]

Formula: [name] | Hook: [type] | CTA: [type] | Optimizes for: [signal]


4. THREADS

[Ready to copy-paste caption text]

[1 topic tag]

Formula: [name] | Hook: [type] | CTA: [type] | Optimizes for: [signal]


5. FACEBOOK (Page/Personal)

[Ready to copy-paste caption text]

Formula: [name] | Hook: [type] | CTA: [type] | Optimizes for: [signal]


6. FACEBOOK GROUP

[Ready to copy-paste caption text]

Formula: [name] | Hook: [type] | CTA: [type] | Optimizes for: [signal]


7. YOUTUBE SHORTS

Title:

[Ready to copy-paste title — max 100 characters]

Description:

[Ready to copy-paste description]

[3-5 hashtags]

Formula: [name] | Hook: [type] | CTA: [type] | Optimizes for: [signal]


STEP 3: End with

"Want me to adjust any of these? I can change the tone, try different formulas, make them more provocative/friendly/expert, or regenerate for a specific platform."


PLATFORM RULES (CRITICAL — follow exactly)

INSTAGRAM REELS
  • Length: 80-200 characters. Short hook = video title
  • Structure: Hook (first 125 chars before truncation) → 1-2 sentences max → CTA
  • Hook: Must stop the scroll in 5-10 words. Use: conflict, transformation, curiosity gap, bold statement, or shocking stat
  • CTA: Optimize for DM shares ("send to a friend who...") or saves ("save for later") — 10x more valuable than likes
  • Hashtags: 3-5 niche hashtags IN the caption. Never #fyp, #viral, #instagood, #like4like
  • SEO: Primary keyword in first 2 sentences
  • NO: Engagement bait, emoji in first line, generic phrases
  • Length: 300-900 characters. Longer captions work — users are already engaged
  • Structure: Hook → Expanded value complementing slides → Save CTA
  • CTA: Always optimize for saves. Carousels with save CTA get +68% saves
  • Body: Lists, step-by-step, checklists. Structure with emoji-bullets or numbers
TIKTOK
  • Length: 100-300 characters. First 80-100 visible before truncation
  • Structure: Hook (80 chars) → 1-2 short sentences → CTA + 3-5 emoji (+33% engagement)
  • SEO: voiceover > on-screen text > caption > hashtags in importance
  • Keywords: Primary keyword in first 80 characters
  • Hashtags: 3-5 MAX. Formula: 1 niche + 1 thematic + 1 trending. NEVER #fyp, #foryou, #viral
  • Completion rate: 70%+ needed for viral. Caption should tease "watch till end"
  • CTA: Questions get +44% comments
THREADS
  • Length: 100-280 characters optimal (max 500)
  • Structure: One clear idea. Conversational tone, like a group chat
  • Tags: Only 1 topic tag per post. Can be multi-word. Niche > broad
  • Engagement: Replies are #1 signal. Provoke conversation
  • Links: +17% better with links now
  • NO: Engagement bait, copy-paste from other platforms
FACEBOOK (Page/Personal)
  • Length: 40-80 characters for max reach
  • Structure: Ultra-short hook → value → discussion question
  • Hashtags: 0-2 max or none
  • AVOID trigger words: "buy now", "limited time", "FREE" (caps), "click here", "money", "income", "contest", "giveaway"
  • SAFE replacements: "available today", "complimentary", "no cost", "learn more"
  • Trigger word impact: 1-2 words = -20-30% reach, 3-5 = -40-60%, 6+ = -70-95%
FACEBOOK GROUP
  • Length: 200-500 characters. Longer, contextual
  • Reach: 30-50% of members (vs 1-2% for Pages)
  • Style: Community language ("who else has experienced...", "curious what you all think about...")
  • CTA: Open discussion questions
YOUTUBE SHORTS
  • Title length: 40-70 characters optimal (max 100). Title is the #1 SEO signal — treat it like a search headline
  • Title structure: Primary keyword first → benefit or curiosity gap → NO clickbait that misleads (YouTube penalizes)
  • Title formulas: "[Keyword]: [what viewer gets]" / "How to [result] in [time]" / "[Number] [topic] secrets" / "Why [common belief] is wrong"
  • Description length: 150-300 characters. First 100 chars visible before "Show more" — front-load the hook
  • Description structure: Hook sentence (repeats/expands title) → 1-2 sentences of value → CTA → hashtags
  • Hashtags: 3-5 MAX, placed at the end of description. 1 broad category + 1-2 niche + 1 topic-specific. NEVER #shorts as the only tag
  • SEO: YouTube is a search engine. Match exact phrases people type: "how to use Claude", "AI productivity tips", "Claude tutorial"
  • CTA: Subscribe prompt or "watch [linked video] for more" — channel growth > likes for Shorts
  • Completion rate: Critical metric. Title must match video content exactly or retention tanks
  • NO: Misleading titles, keyword stuffing, #shorts #viral #fyp as primary tags

CAPTION FORMULAS (use different ones for each platform)

Show full SKILL.md (506 more words)Show less
For REACH:
  1. Trend-Hook + Benefit: "[Trend]: [benefit] for [audience]"
  2. Curiosity X vs Y: "[A] vs [B]: which works better for [situation]?"
  3. Myth Buster: "Myth: [belief]. Fact: [rebuttal]"
  4. Data Teaser: "[Number] → [result] in [timeframe]"
  5. What Works Now: "What works in [niche] right now: [1], [2], [3]"
  6. Watch Time Promise: "In [time] you'll get [result]. Watch till end for [bonus]"
  7. Beginner's Path: "New to [field]: [step 1] → [step 2] → [step 3]"
For ENGAGEMENT:
  1. Micro-Decision: "Are you [A] or [B]? And why?"
  2. Hot Take: "Unpopular opinion: [thesis]. Agree or disagree?"
  3. Rate These 3: "Rank by importance: [1], [2], [3]"
  4. This or That: "[A] or [B] for [situation]? Your pick?"
  5. Fill in the Blank: "Complete: 'The best advice about [topic] was...'"
For SALES:
  1. POOPC: "Struggling with [pain]? [Result] in [time] with [product]"
  2. Objection Destroyer: "Think '[objection]'? Actually, [counter]"
  3. Social Proof Lead: "'[Client quote]'. Here's how:"
For GROWTH:
  1. Series: "Day [1/N] of [topic]. Follow for the rest"
  2. Lead Magnet: "Free [resource] on [topic]. Comment '[word]'"
  3. Cliffhanger: "10 lessons from [experience]. Today — first 3. Rest for followers"

HOOK LIBRARY

Provocation:
  • "Stop [doing X] — here's why"
  • "Nobody talks about this [topic] hack"
  • "You're doing [X] wrong"
Curiosity:
  • "Here's what no one tells you about [topic]"
  • "Mistake #1 that kills your [metric]"
  • "I tested [N] methods. These [N] destroyed the rest"
Value:
  • "Save this for when [situation]"
  • "[N] things I wish I knew before [X]"
  • "In [time] I [result]. Here's how:"
Emotion:
  • "Honest truth about [topic]"
  • "One change flipped everything"
  • "Unpopular opinion: [bold claim]"
TikTok-specific:
  • "Stop scrolling if you [situation]"
  • "POV: you just discovered [thing]"
  • "I spent [money/time] so you don't have to"

ANTI-PATTERNS (NEVER do these)

Engagement bait (-50-90% reach on ALL platforms):
  • "Like if you agree" / "Comment YES" / "Tag 3 friends"
  • "Share before they delete this" / "React with [emoji] if..."
Shadow ban triggers:
  • Violence words (even in innocent context)
  • Adult content words
  • Financial promises: "guaranteed income", "get rich quick"
  • Letter substitution does NOT help — algorithms detect it
Format crimes:
  • Same hashtags on every post (spam flag)
  • More than 5 hashtags (limit since late 2025)
  • Wall of text without line breaks
  • #fyp, #foryou, #viral — useless and harmful

POWER WORDS (use 2-3 per caption)

CategoryWords
UrgencyNow, Today, Limited, Last chance
TrustProven, Tested, Research-backed, Results
ExclusivitySecret, Hidden, Insider, Behind-the-scenes
EmotionShocking, Surprising, Honest, Raw, Real
ActionDiscover, Unlock, Transform, Master, Grab
ValueFree, Bonus, Cheat sheet, Blueprint, Toolkit

SIGNAL HIERARCHY (all platforms, 2025-2026)

  1. Shares/DM sends — strongest (~10x a like)
  2. Saves — very strong, especially Instagram
  3. Comments — strong, especially meaningful ones
  4. Watch time / Completion rate — dominant for video (70%+ for viral)
  5. Likes — weakest, "vanity metric"

QUALITY CHECKLIST (verify before presenting)

  • Hook in first 80-125 characters
  • 1-3 SEO keywords naturally integrated
  • ONE clear CTA per caption
  • 2-3 power words (not more)
  • 3-5 niche hashtags (not generic) where applicable
  • Zero engagement bait
  • Zero shadow ban triggers
  • Zero Facebook trigger words (for FB captions)
  • Short paragraphs with line breaks
  • Different formula for each platform

© rediumvex, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 2 other files in the repository root of rediumvex/social-media-caption-generator-claude.

  • SKILL.md
  • LICENSE
  • README.md

Open the folder on GitHubat commit 37cad54

Compare with similar skills

Social Captions 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.

Social Captions compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Social Captions this skillrediumvex/social-media-caption-generator-claude131—~2.7kAutomated safety check: NotesMIT
AI Social Media ContentNeverSight/learn-skills.dev2171 repos~1.8kAutomated safety check: PassNone
Socialcoreyhaines31/marketingskills54k4 repos~4.5kAutomated safety check: PassMIT
Social Cover DirectorJamailar/Beav1.8k—~1.7kAutomated safety check: WarnCustom licence
Kortix Socialkortix-ai/suna20k—~1.8kAutomated safety check: PassCustom licence
Outlier Post FinderScrapeCreators/social-media-research-skills3.4k—~1.5kAutomated safety check: NotesMIT

Similar skills

  • AI Social Media Content

    NeverSight/learn-skills.dev

    Create AI-powered social media content for TikTok, Instagram, YouTube, Twitter/X.

    217 GitHub starsUsed in 1 repo~1.8k tokens
    Writing & ContentAuto-check passed
  • Social

    coreyhaines31/marketingskills

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, or Facebook, or wants to do social listening and engagement triage.

    54k GitHub starsUsed in 4 repos~4.5k tokens
    Writing & ContentAuto-check passed
  • A skill your agent uses when the user wants to plan or generate a social media cover image for a Xiaohongshu note, Douyin/TikTok photo post, Reels/Shorts cover, WeChat/Video Account post…

    1.8k GitHub stars~1.7k tokensUpdated 2 days ago
    Media & CreativeAuto-check: warnings
  • Kortix Social

    kortix-ai/suna

    Recipe: write platform-native social content for Kortix (LinkedIn posts, X threads, carousels, Instagram, TikTok, Reels and Shorts video scripts, content calendars) and repurpose one long-form piece…

    20k GitHub stars~1.8k tokensUpdated today
    Writing & ContentAuto-check passed
  • 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.

    3.4k GitHub stars~1.5k tokensUpdated 1 mo ago
    Writing & ContentAuto-check: notes
  • Caption Writer

    social-media-skills/skills

    A skill your agent uses to write platform-native social media captions (post copy) in the brand's voice — the words that accompany a post on Instagram, LinkedIn, TikTok, Facebook, X/Twitter…

    134 GitHub stars~1.7k tokensUpdated 9 days ago
    Writing & ContentAuto-check passed

Works with

Questions about Social Captions

What does Social Captions do?

Write algorithm-optimized captions/descriptions for social media posts and reels. Social Captions is an agent skill from rediumvex/social-media-caption-generator-claude. Write algorithm-optimized captions/descriptions for social media posts and reels.

When should I use Social Captions?

Social Captions fits situations like: asked to write a caption; write a description; caption for instagram; Описание к посту.

How do I install Social Captions in Claude Code?

Run `npx skills add rediumvex/social-media-caption-generator-claude --skill social-captions -a claude-code`. Or copy the skill folder (the rediumvex/social-media-caption-generator-claude repository) into .claude/skills/social-captions in your project. Claude Code loads it when a task matches its description.

How do I install Social Captions in Codex?

Run `npx skills add rediumvex/social-media-caption-generator-claude --skill social-captions -a codex`. Or copy the skill folder (the rediumvex/social-media-caption-generator-claude repository) into .agents/skills/social-captions in your project. Codex loads it when a task matches its description.

Can I use Social Captions 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 rediumvex/social-media-caption-generator-claude --skill social-captions -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/social-captions, .gemini/skills/social-captions, .github/skills/social-captions and .opencode/skills/social-captions in your project.

What does Social Captions need to run?

SKILL.md names no scripts, command-line tools or credentials: Social Captions is instructions for the agent only. Its frontmatter pre-approves these tools: Bash, Read, Write, Edit, Glob, Grep.

Does Social Captions 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 Social Captions safe to install?

Our automated static check of SKILL.md found notes only (pre-approves every shell command (allowed-tools: bash)), nothing it rates as a warning. It is not a guarantee. Review the folder before installing.

What licence does Social Captions use?

Social Captions is published under the MIT licence (from the LICENSE file in the skill folder). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Social Captions use?

About 2.7k tokens (SKILL.md is roughly 11k 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 Social Captions?

Skills that share tags, products or a category with Social Captions: AI Social Media Content (NeverSight/learn-skills.dev, 217 stars), Social (coreyhaines31/marketingskills, 54k stars), Social Cover Director (Jamailar/Beav, 1.8k stars) and Kortix Social (kortix-ai/suna, 20k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Social Captions?

rediumvex (a GitHub user) maintains it in rediumvex/social-media-caption-generator-claude, which has 131 GitHub stars. The repository was last updated on August 11, 2026.

Source: rediumvex/social-media-caption-generator-claude on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.