Skip to main content
skill CX Codex

ig-caption-writer — Claude Code skill: write Instagram posts that stop the scroll

ig-caption-writer is a skill that drafts Instagram captions with a hook in the first 125 characters, a skimmable body, and one CTA.

MIT ★ 897 updated 2026-10-21

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add sergebulaev/instagram-skills
/plugin install instagram-skills@instagram-skills
Open on GitHub

What ig-caption-writer does

ig-caption-writer solves one problem: write a post that stops the scroll. Instagram hides everything after ~125 characters behind "more", so the hook must work on its own—the first line carries all the weight. The skill front-loads the hook, keeps the body skimmable with short lines, and adds one concrete next step.

You pick a goal (saves→IG1, shares→IG2, comments→IG3 or IG4, follows→IG4), and the skill suggests 2–3 matching formulas. It writes the post based on your choice, sourcing specifics (numbers, dates, names) from what you've said—it doesn't invent. Then it runs a humanizer pass to strip AI-speak (stock phrases like "let's talk", excess em dashes, stacked lists, manufactured drama).

With a Publora key and media attached, the skill publishes on your approval. For carousel posts (IG5–IG8), use ig-carousel-planner. For Reels, the hook lives in the video—this skill writes the supporting caption. Without media or a Publora key, the skill returns a copy-paste block and reminds you to attach the image or video.

What it helps with

  • write a hook that stops the scroll in the first 125 characters
  • pick a post formula by intended action (saves, shares, comments)
  • remove AI-speak and clichés from a draft caption
  • publish the post with an image or video in one step

Example prompts for the agent

  • Write an Instagram caption about our Q3 sales report—I want saves
  • Draft a caption for a Reel on three mistakes when launching: go for comments
  • Sharpen the hook so the first 125 characters work on their own

How to install ig-caption-writer

1Plugin marketplace

/plugin marketplace add sergebulaev/instagram-skills
/plugin install instagram-skills@instagram-skills

This installs the whole instagram-skills plugin with all its skills

2Skills CLI (Vercel)

npx skills add sergebulaev/instagram-skills --skill ig-caption-writer -a claude-code

3Manually: put the files in place

~/.claude/skills/ig-caption-writer/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/ig-caption-writer/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about ig-caption-writer

How do I install ig-caption-writer in Claude Code?

Run these commands in order: /plugin marketplace add sergebulaev/instagram-skills, then /plugin install instagram-skills@instagram-skills, then npx skills add sergebulaev/instagram-skills --skill ig-caption-writer -a claude-code. The config lives in ~/.claude/skills/ig-caption-writer/SKILL.md.

What does ig-caption-writer do?

It drafts an Instagram post with a hook in the first 125 characters, a skimmable body, and one CTA. It picks a formula based on your goal (saves, shares, comments, or follows), scrubs the text for AI-voice, and can publish with media via Publora.

How do I choose the right formula?

Start with your goal: saves→IG1, shares→IG2, comments→IG3 or IG4, follows→IG4. The skill will suggest 2–3 formulas that fit your topic, and you pick one.

Source text

SKILL.md · MIT
---
name: ig-caption-writer
description: "Draft an Instagram caption with the hook in the first 125 characters, a skimmable body, and one clear CTA, using a 2026 hook formula chosen by goal (saves, shares, comments, follows). Runs the humanizer pass and, on approval, publishes with the image or video you supply via the Publora media flow. Use to caption a single image or a Reel. Not for slide-by-slide carousels (use ig-carousel-planner) or auditing a draft (use ig-humanizer --mode audit)."
---

# Instagram Caption Writer

Write a caption that earns the tap and the save. Instagram hides everything after
~125 characters behind "more", so the hook does the entire job in the first
line. This skill front-loads that hook, keeps the body skimmable, and lands one
clear call to action.

## When to use

- User says "write me an Instagram caption about X"
- User has a single image or a Reel and needs the caption around it
- User wants a sharper hook for a draft they already have
- User wants a caption that auto-publishes with their media on approval

## Formulas this skill uses (caption-first shapes)

| Code | Formula | Primary goal | Best for |
|---|---|---|---|
| IG1 | Number-First Result | saves | one odd-precision result + a "steal this" promise |
| IG2 | Contrarian Truth | shares | a sharp, defensible against-the-grain claim |
| IG3 | Relatable Cold-Open | comments | a specific shared moment, no setup |
| IG4 | Mini-Story Confession | comments, follows | a real first-person story with a cost |

Full skeletons in `../../references/hook-formulas.md`. For carousels (IG5-IG8) use
`ig-carousel-planner`; for Reels (IG9-IG10) the hook lives in the video, and this
skill writes the supporting caption.

### Pick by goal first

| Goal | Reach for |
|---|---|
| Saves | IG1 |
| Shares | IG2 |
| Comments | IG3, IG4 |
| Follows | IG4 |

## Steps

**Voice profile first (all drafts).** If `../../references/voice-profile.md` has `filled: yes`, load it and match the user's voice fingerprint, hard rules, and CTA/link style throughout. If it is not filled, mention once that `ig-humanizer --mode profile` can learn their voice from a few posts, then proceed with the generic voice rules.

**Never invent the specifics.** The rules below ask for a concrete number, a date and a named entity, because that is what separates a real post from a generated one. Take them from what the user actually said in this conversation. **Do not invent a figure, a date, a client name or a result, and do not soften a vague claim into a plausible-looking number.** If the user has nothing concrete for a beat, ask them once, and if they still have nothing, drop the claim rather than decorate it. A published invented number is a retraction; a missing one is only a weaker post.

1. **Gather inputs.** Topic, angle, the media (single image or Reel), target
   audience, and the goal (saves / shares / comments / follows).
2. **Pick the formula.** Use the goal table to shortlist, then suggest 2-3 that
   also fit the topic and let the user choose.
3. **Write the hook (first 125 chars).** It must land the payoff, tension, or
   number before the "more" fold and make sense on its own.
4. **Write the body.** Short lines, white space between beats, one idea. Teach or
   tell the story that the hook promised. Keep it under 2,200 chars.
5. **Write one CTA.** A specific save or send prompt ("save this for your next
   launch", "send to the friend who keeps doing #2"), a real question, or a
   single next step. Never "what do you think?".
6. **Add hashtags.** Hand off the topic to `ig-hashtag-strategist` or apply the
   3-5 sized set yourself (see `../../references/hashtag-strategy.md`). Put them at
   the end or note they go in the first comment.
7. **Humanizer pass.** Scrub 2026 AI vocab by paragraph density, cap em
   dashes (about one per 100 words; a caption's single dash is not a tell,
   never swap one for a period), break stacked triads, generic openers and
   reveal bridges. Fix only a paragraph that reads machine-flat; never
   manufacture variance or one-word lines for drama. Add an odd-precision
   number with a named referent or a named entity where the claim allows.
   Canonical rules: `ig-humanizer` V3.
8. **Optional audit.** Invoke `ig-humanizer --mode audit` for a pass-fail check.
9. **Approval card.** Show: formula used, the hook (flag if over 125 chars),
   full caption, char count, hashtag set, primary goal, and the media the user
   must supply.
10. **On approval, publish with media.** Call `lib.publish(kind="post",
    draft_text=<approved caption>, target_url="https://www.instagram.com/",
    media=[<local file paths>], platforms=[<INSTAGRAM_PLATFORM_ID>],
    scheduled_time=<iso_or_None>)`. For a Reel pass `kind="reel"`. The wrapper
    runs the Publora draft then upload then schedule flow. With no media or no
    Publora key it returns a copy-paste block and a reminder to attach the media.

## Hard rules

Global voice rules: see root `SKILL.md` Voice rules. Additional skill-specific
rules:

- The first 125 characters must stop the scroll on their own. Rewrite any hook
  that needs the second line to make sense.
- One idea per caption. Two ideas means two posts.
- One specific number where the claim allows it.
- 3-5 sized hashtags, never 30. 0-3 emoji, placed with intent.
- Media is required. Never present a caption as publishable without reminding
  the user to attach the image or video.
- Do not hard-sell. One natural mention of the next step, max.

## Anti-patterns (skill will refuse)

- A hook that only makes sense after the fold.
- Em dashes above the cap (more than about one per 100 words), or an em dash swapped for a period.
- "Let's talk about.." or "Here's the thing.." openers; "The result?" as a reveal.
- Announced candor ("real talk", "not gonna lie", "POV:" on something that is not a POV) with no dated fact behind it.
- Staccato stacks ("No X. No Y. Just Z.") and one-word lines added for drama.
- 20-30 hashtags stuffed at the top.
- Engagement bait ("double tap if you agree", "comment YES").
- Rule-of-three lists without specifics.
- "leverage", "fundamentally", "game-changer", "level up", "dive in".
- Padding a one-line idea to look substantial.

## Resources

- `../../references/hook-formulas.md` - all 10 Instagram formulas (IG1-IG4 are caption-first)
- `../../references/algorithm-heuristics.md` - 2026 Instagram ranking rules
- `../../references/hashtag-strategy.md` - the 3-5 sized hashtag recipe
- `../../references/media-workflow.md` - the draft, upload, schedule flow
- `references/caption-checklist.md` - the per-caption scrub and fit list

## Related skills

- `ig-carousel-planner` - when the idea is a slide-by-slide carousel
- `ig-hashtag-strategist` - build the sized hashtag set
- `ig-humanizer` - AI-tell scrubber, plus `--mode audit` for review
- `ig-hook-extractor` - reverse-engineer a hook from a post you admire

© Serge Bulaev · MIT · sergebulaev/instagram-skills

Similar skills

All skills for Marketing and content →

From the same set11

The whole set →
ig-hook-extractor ig-hook-extractor is a Claude Code skill that breaks down hooks in Instagram Reels and carousels from a URL or pasted text. It identifies the formula, post goal, and a template for your topic. CX Codex +1 ★ 897repo stars ig-content-planner ig-content-planner turns a theme, an audience, and content pillars into a 7-day Instagram posting calendar with formats, hooks, and goals for each slot. CX Codex +1 ★ 897repo stars ig-audience-insights ig-audience-insights reads Instagram hashtags and competitor profiles using real data from Apify without needing an account login. Finds top-performing post patterns. CX Codex +1 ★ 897repo stars ig-profile-optimizer The ig-profile-optimizer skill reviews nine parts of an Instagram profile and suggests edits based on the account’s goal. Use it to rethink the profile header and opening grid. CX Codex +1 ★ 897repo stars ig-carousel-planner ig-carousel-planner maps multi-slide Instagram carousels up to 10 slides, writes on-image text, prepares captions, and schedules posts through Publora. CX Codex +1 ★ 897repo stars ig-repurposer ig-repurposer rebuilds LinkedIn posts, blog pieces, YouTube scripts, and X threads for Instagram. It reshapes the hook and format, then sends the approved post through Publora. CX Codex +1 ★ 897repo stars ig-humanizer ig-humanizer rewrites an Instagram caption or carousel slide to strip the patterns readers associate with AI text, and can run a pre-publish checklist without rewriting anything. CX Codex +1 ★ 897repo stars instagram-skills instagram-skills is a Claude Code plugin for creating and planning Instagram content. Its skills activate on requests about captions, carousels, or a posting plan. CX Codex ★ 897repo stars

Project sponsors

Companies that keep this analytics open