Agent skill

Caption Writer

by social-media-skills in 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…

MITAuto-check passedWriting & Content

Install Caption Writer

skills CLI
$ npx skills add social-media-skills/skills --skill caption-writer -a claude-code

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

GitHub CLI
$ gh skill install social-media-skills/skills caption-writer --agent claude-code

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

Manual copy
$ git clone --depth 1 https://github.com/social-media-skills/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/caption-writer .claude/skills/caption-writer && rm -rf skills-src

Use ~/.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/

Facts

Skill name
caption-writer
GitHub stars
134
Token cost
~1.7k tokens
SKILL.md length
880 words
Files
7 (incl. references)
Skills in repo
106
Repo updated
First seen
Licence
MIT

At a glance

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…

  • Works in 7 steps: Read the foundation first (required) → Establish four inputs → Choose the format, then the goal-driven… → …
  • Write platform-native social media captions (post copy) in the brands voice — the words that accompany a post on Instagram
  • SKILL.md covers Step 0 — Read the foundation…, Step 1 — Establish four inputs, Step 2 — Choose the format,… and Step 3 — Write the first line…, plus 7 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Caption Writer is an agent skill from social-media-skills/skills. Use 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, Threads, Pinterest, YouTube, or Bluesky. Run when the user says "write a caption," "caption this," "post copy," "write the copy for this photo/video/Reel," "IG caption," "what should I write for this post," or needs the words to go with a visual. Reads brand-profile and voice first so captions sound like the brand, not generic AI. For long-form…

Its SKILL.md is about 1.7k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including reference files (for example `evals/evals.json`, `references/examples.md` and `references/first-line.md`).

It sits in Writing & Content, covering Social media posts and Video scripts and shorts. It works with LinkedIn, Bluesky, Instagram and Pinterest. The repository describes itself as: 106 social media skills for AI agents - strategy, writing, video, design, platform growth, publishing, and analytics. Works with Claude, Cursor, OpenClaw, Hermes & 40+ agents. The licence is MIT.

When your agent uses it

  • Write platform-native social media captions (post copy) in the brands voice — the words that accompany a post on Instagram
  • Says write a caption
  • Write the copy for this photo/video/Reel
  • What should I write for this post

Example prompts

  • “write a caption,”
  • “caption this,”
  • “post copy,”
  • “/caption-writer”

Workflow steps

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

  1. Read the foundation first (required)
  2. Establish four inputs
  3. Choose the format, then the goal-driven structure
  4. Write the first line first
  5. Build the body and one CTA
  6. Mechanics: hashtags, links, formatting
  7. Deliver options, recommend one

What it can do on your machine

Read from SKILL.md and the folder at commit 6e30eeb. 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

    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

Caption Writer loads about 1.7k tokens when it runs, and up to ~6.7k if it reads all its reference files. Until then it costs about 181 tokens; SKILL.md has 880 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
~1.7k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~6.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 passed

The automated check found no risky patterns in SKILL.md.

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 social-media-skills/skills at commit 6e30eeb, republished under its MIT licence (© social-media-skills). 880 words, ~1,730 tokens.

Download SKILL.mdSave it as .claude/skills/caption-writer/SKILL.md (or your agent's skills folder). This skill also uses 6 other files; get the full folder from GitHub.
name
caption-writer
description
Use 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, Threads, Pinterest, YouTube, or Bluesky. Run when the user says "write a caption," "caption this," "post copy," "write the copy for this photo/video/Reel," "IG caption," "what should I write for this post," or needs the words to go with a visual. Reads brand-profile and voice first so captions sound like the brand, not generic AI. For long-form LinkedIn thought-leadership posts use linkedin-post-writer; for X/Threads multi-post threads use thread-writer; for video scripts use the video skills. This skill writes the caption itself.
metadata.version
1.0.0
license
MIT

Caption Writer

A caption is not a description of the post. It's the part of the post that does the work — it stops the scroll, earns attention, and drives one action. Done well it carries the post; done generically it sinks even great visuals under emoji and hashtag noise.

Two principles run through everything here:

  1. The first line is the whole game. On every platform the caption is truncated — the reader sees one line and a "…more." If that line doesn't earn the tap, the rest is never read. Write the first line like its only job is to win the second line.
  2. Every caption serves one goal. Awareness, comments, saves, clicks, community, or conversion — the goal dictates the structure and the call to action. A caption "to get engagement" is a caption with no goal.

Step 0 — Read the foundation first (required)

Load brand-profile.md and voice.md before writing a word. The voice fingerprint, the "never" list, and the brand guardrails are non-negotiable. A caption that doesn't sound like them is a failure even if it's clever. If neither exists, run brand-profile (and voice-builder if samples exist) first.

Step 1 — Establish four inputs

Don't write until you know these. Infer what you can; ask only what you can't:

  • Platform — the mechanics are different on each (see references/platforms.md).
  • The asset — what's in the photo/video/carousel? The caption complements the visual; it shouldn't narrate what the eye already sees.
  • The goal — awareness, comments, saves, clicks/traffic, community, or conversion.
  • The topic / point — what this specific post is about, and the one idea it lands.

If the user gives you only "write a caption for this," ask at most one or two questions (usually platform + goal) and proceed.

Step 2 — Choose the format, then the goal-driven structure

Pick the caption format that fits the asset and point — story, value/how-to, hot take, question, behind-the-scenes, social proof, announcement, relatable (see references/formats.md). Then shape it with the goal-driven structure and CTA from references/frameworks.md. Format gives it a recognizable shape; goal gives it a job.

Step 3 — Write the first line first

Spend disproportionate effort here. Draft 3–5 candidate opening lines and pick the one that most makes a stranger need the next line — within the platform's preview cutoff. Never waste the first line on a greeting, a hashtag, "Happy Monday!", or a restatement of the image. See references/first-line.md.

Step 4 — Build the body and one CTA

  • Body: deliver the value or story the first line promised, in the brand's voice, at the right length for the platform and goal (short isn't always better — match it). Use line breaks and whitespace where the platform rewards scannability.
  • CTA: exactly one, matched to the goal ("save this for your next launch," "what would you add?", "link in bio"). Two CTAs split the action and kill both. Respect any "never hard-sell here" guardrails from the brand profile.

Apply the platform's current norms from references/platforms.md: how many hashtags (and whether to use any), where links go and whether they hurt reach, line-break rendering, and the ideal length. Getting mechanics wrong makes a good caption underperform.

Show full SKILL.md (360 more words)Show less

Step 6 — Deliver options, recommend one

Give the user 2–3 distinct caption options (genuinely different angles or formats, not the same caption reworded), then recommend one with a one-line rationale tied to the goal. People choose faster from real alternatives than from a single take.

Quality bar — self-check before delivering

  • Does the first line stop the scroll on its own, inside the preview cutoff?
  • Does it sound like them — fingerprint hit, "never" list respected, banned words absent?
  • Is there one clear CTA matched to the goal?
  • Does the caption complement the asset rather than describe it?
  • Are hashtags/links/length correct for the platform?
  • Would a real person stop, read, and act — or scroll past?

If the first line is weak, rewrite it before anything else. It's 80% of the result.

Edge cases

  • No asset described: ask what's in it, or write a caption that works for the stated topic and flag that the first line may need tuning to the visual.
  • Multiple platforms requested: don't paste the same caption everywhere. Adapt the hook, length, hashtags, and CTA to each platform's mechanics (see cross-platform-repurposing for doing this at scale).
  • Regulated/sensitive brand: apply the brand profile's compliance guardrails — no forbidden claims, required disclaimers, careful CTAs.
  • Carousel / multi-image: the caption supports the swipe — the first line should pull people into slide 1; consider a "keep reading / swipe" nudge only if it fits the voice.
  • Link-driven goal on a no-link platform (e.g., Instagram feed): route to "link in bio" and say so; don't write a clickable-link CTA where links aren't clickable.
  • Very short-form platforms (X, Threads, Bluesky): the caption is the whole post — lead with the point, cut everything else.
  • brand-profile, voice-builder — read first; supply voice and guardrails.
  • hook-writer — for deeper work on the opening hook.
  • linkedin-post-writer, thread-writer — specialized long-form / thread copy.
  • hashtag-strategy — for a fuller hashtag system.
  • cross-platform-repurposing — adapt one caption across many platforms.
  • scheduling-and-queue — push the finished caption to WoopSocial to schedule.

References

  • references/platforms.md — per-platform caption mechanics (limits, fold, hashtags, links).
  • references/frameworks.md — caption structure, goal→structure mapping, length, CTA library.
  • references/formats.md — caption formats/archetypes and when to use each.
  • references/first-line.md — opening-line craft; winning the "…more" tap.
  • references/examples.md — worked captions across platforms and goals.

© social-media-skills, 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 6 other files (references) in skills/caption-writer of social-media-skills/skills.

  • SKILL.md
  • evals/evals.json
  • references/examples.md
  • references/first-line.md
  • references/formats.md
  • references/frameworks.md
  • references/platforms.md

Open the folder on GitHubat commit 6e30eeb

Compare with similar skills

Caption Writer 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.

Caption Writer compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Caption Writer this skillsocial-media-skills/skills134—~1.7kAutomated safety check: PassMIT
Outlier Post FinderScrapeCreators/social-media-research-skills3.4k—~1.5kAutomated safety check: NotesMIT
Hook Writer Smsblacktwist/social-media-skills560—~3.7kAutomated safety check: PassMIT
Caption Writer Smsblacktwist/social-media-skills560—~5.3kAutomated safety check: PassMIT
Content Repurposer Smsblacktwist/social-media-skills560—~3.7kAutomated safety check: PassMIT
Social Media Managementmanojbajaj95/claude-gtm-plugin1051 repos~3.9kAutomated safety check: PassMIT

Similar skills

  • 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
  • Hook Writer Sms

    blacktwist/social-media-skills

    When the user wants help writing opening lines, hooks, first sentences, video hooks, thumbnails titles, or pin titles that grab attention.

    560 GitHub stars~3.7k tokensUpdated 5 mo ago
    Writing & ContentAuto-check passed
  • Caption Writer Sms

    blacktwist/social-media-skills

    When the user wants to write a caption for a visual-first social media post on Facebook, Instagram, TikTok, Pinterest, or YouTube.

    560 GitHub stars~5.3k tokensUpdated 5 mo ago
    Writing & ContentAuto-check passed
  • Content Repurposer Sms

    blacktwist/social-media-skills

    When the user wants to turn one piece of content into multiple formats or adapt content across text-first and visual-first platforms (LinkedIn, Twitter/X, Threads, Bluesky, Facebook, Instagram…

    560 GitHub stars~3.7k tokensUpdated 5 mo ago
    Writing & ContentAuto-check passed
  • Social Media Management

    manojbajaj95/claude-gtm-plugin

    Comprehensive social media management for all platforms (LinkedIn, Twitter/X, Instagram, TikTok, Facebook, Pinterest, YouTube).

    105 GitHub starsUsed in 1 repo~3.9k tokens
    Writing & ContentAuto-check passed
  • Post Writer Sms

    blacktwist/social-media-skills

    When the user wants to write a social media post for LinkedIn, Twitter/X, Threads, Bluesky, Facebook, Instagram, TikTok, Pinterest, or YouTube.

    560 GitHub stars~3.7k tokensUpdated 5 mo ago
    Writing & ContentAuto-check passed

More from social-media-skills/skills

All 106 skills in this repo
  • AI Image Editing

    social-media-skills/skills

    The AI image-editing router — inpainting/object removal, background removal, upscaling, outpainting, old-photo restoration, and retouch, routed task-first to the right engine.

    134 GitHub stars~2.1k tokensUpdated 9 days ago
    Auto-check passed
  • AI Music And Sound

    social-media-skills/skills

    The AI music + sound-design skill for social -- original/licensed audio beds and sound design for Reels/TikToks/Shorts/videos.

    134 GitHub stars~1.9k tokensUpdated 9 days ago
    Auto-check passed
  • AI Search Optimization

    social-media-skills/skills

    A skill your agent uses to get a brand and its content CITED and RECOMMENDED by AI answer engines — the GEO (Generative Engine Optimization) / AI-search-visibility skill.

    134 GitHub stars~2k tokensUpdated 9 days ago
    Auto-check passed
  • AI Video

    social-media-skills/skills

    The model-agnostic AI-video router and brief — the counterpart to image-prompt.

    134 GitHub stars~1.3k tokensUpdated 9 days ago
    Auto-check passed
  • AI Voiceover

    social-media-skills/skills

    The AI narration / voiceover mini-skill (ElevenLabs-led). An agent skill from social-media-skills/skills.

    134 GitHub stars~1.1k tokensUpdated 9 days ago
    Auto-check passed
  • Analytics And Reporting

    social-media-skills/skills

    Social media analytics and reporting — read native platform data honestly and turn it into next actions.

    134 GitHub stars~1.4k tokensUpdated 9 days ago
    Auto-check passed

Questions about Caption Writer

What does Caption Writer do?

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…. Caption Writer is an agent skill from social-media-skills/skills. Use 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, Threads, Pinterest, YouTube, or Bluesky.

When should I use Caption Writer?

Caption Writer fits situations like: write platform-native social media captions (post copy) in the brands voice — the words that accompany a post on Instagram; says write a caption; write the copy for this photo/video/Reel; what should I write for this post.

How do I install Caption Writer in Claude Code?

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

How do I install Caption Writer in Codex?

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

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

What does Caption Writer need to run?

SKILL.md names no scripts, command-line tools or credentials: Caption Writer is instructions for the agent only.

Does Caption Writer 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 Caption Writer safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Caption Writer use?

Caption Writer is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Caption Writer use?

About 1.7k tokens (SKILL.md is roughly 6.9k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 5k tokens, read only when the agent opens those files.

What are the alternatives to Caption Writer?

Skills that share tags, products or a category with Caption Writer: Outlier Post Finder (ScrapeCreators/social-media-research-skills, 3.4k stars), Hook Writer Sms (blacktwist/social-media-skills, 560 stars), Caption Writer Sms (blacktwist/social-media-skills, 560 stars) and Content Repurposer Sms (blacktwist/social-media-skills, 560 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Caption Writer?

social-media-skills (a GitHub organization) maintains it in social-media-skills/skills, which has 134 GitHub stars. The repository holds 106 skills in this directory. The repository was last updated on October 1, 2026.

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