Let Claude Run Your Instagram

What you get

An open-source package that has been getting a lot of buzz in the Claude community lately: instagram-agent-skill. Its author, Jake Schincariol, built 13 Claude skills that help you run Instagram:

Write Reel scripts and score the opening hook
Write captions and check whether the part shown before the "more" fold works
Carousels, Stories, and profile scoring
Plan a weekly posting schedule
Reply to comments and write DMs

Once installed, you type commands like /ig-reel and /ig-plan in Claude.

Set your expectations first: it's a content typist, not a fully automated social manager. It doesn't touch your account and doesn't post on its own. You copy what it writes and post it yourself.

Key features

MIT open source, free. Over 5,000 stars on GitHub.
No API key, no account connection. The author deliberately didn't build auto-posting. Using scripts or third-party tools to auto-post, follow, or DM violates Instagram's terms of use and risks rate limits or account bans.
5 companion tools run locally. Hook scoring, duration estimation, caption checking, de-AI-ifying, and viral ranking are all Python scripts that run on your own computer. They don't connect to the internet or upload anything.
No made-up data. Any number you don't provide gets left as {{your number}} for you to fill in. It won't invent results for you.

Prerequisite: a paid Claude plan

The plugin and skills are used in Claude Code, which requires a paid Claude plan (Pro or higher).

Free users can get by: paste the contents of any skill's SKILL.md at the start of a conversation, and Claude will work in that mode. But you won't have the 5 local tools, and hook scoring and de-AI-ifying depend on them the most.

You also need Python 3 (Macs usually include it; if python3 --version shows a version number in Terminal, you're set).

Step 1: Install (the easiest way)

Open Claude Code and send it this message:

https://github.com/Jakeschincariol/instagram-agent-skill

Install this skill package, then confirm that /ig-reel works.

It will handle the download and copying itself. If you'd rather do it manually, pick one of these two options:

# Option 1: copy the skill folders
git clone https://github.com/Jakeschincariol/instagram-agent-skill.git
cp -r instagram-agent-skill/skills/ig-* ~/.claude/skills/

# Option 2: install as a plugin in Claude Code
/plugin marketplace add Jakeschincariol/instagram-agent-skill
/plugin install instagram-agent

After installing, restart Claude Code once. If typing /ig shows a list of commands starting with ig-, the install worked.

Step 2: Spend 10 minutes writing your "voice"

This step matters most, so don't skip it.

All 13 skills first read one file: ~/.claude/instagram/voice.md. It describes how you talk: what you do, who you talk to, your verbal habits, and words you never use. A Reel is something you say to the camera yourself, and if the style doesn't sound like you, it won't come out of your mouth no matter how good the writing is.

The simplest approach is to send Claude the transcripts (or captions) of 3 Reels you've already posted:

New accounts get 10 free credits, plus 1 more for each daily check-in. Spend 1 credit to unlock and it stays open for you.

If you haven't posted anything yet, describe yourself in a few sentences and have it write a first draft that you can revise later.

Step 3: Write your first Reel

/ig-reel Freelancers always quote too low on their first project

It works through these steps in order:

Produces 3 opening hooks. It picks from 26 common hook patterns, such as "Nobody tells you..." or "I lost how much money because of one thing".
Scores the hooks. It uses hookscore.py to score them, and openings like "Hi everyone, today let's talk about..." get directly marked as weak.
Writes the spoken script and on-screen captions.
Estimates duration. It uses beats.py to work out roughly how many seconds each line takes, and flags a hook running past 3 seconds, a section that runs too long without a change, or an ending that doesn't call back to the opening.

If your idea is too vague, it will first ask you: what actually happened, to whom, and how much you spent or earned. A Reel needs one specific true story.

Step 4: Write the caption and plan the week

/ig-caption Write a caption for the Reel above, keywords: freelancing, quoting

On Instagram's feed, a caption shows only about the first 125 characters before readers have to tap "more". caption.py shows you exactly what appears in that preview and checks the number of hashtags. The author notes that since December 2025 Instagram allows at most 5 hashtags per post, so the tool checks against 5.

/ig-plan Post 4 times next week: 3 Reels and 1 carousel

It gives you a weekly plan: what to post on which day, in what format, and at what time, along with 10 accounts to engage with this week.

Step 5: Remove the AI tone before posting

/ig-human Check this caption

It does two things:

Automatic cleanup: removes em dashes, curly quotes, clichés such as "stop scrolling" and "follow for more", and invisible characters that get pasted in along with text.
Flags without rewriting: patterns like "not just X, but Y", triple parallel lists, and screens full of emojis get flagged so you can revise them yourself, rather than having regex break them.

This package is designed mainly for English content, and its cliché word list is in English. For Chinese content, the hook patterns and workflow still work, but the de-AI-ifying word list is limited, so read it over yourself.

Other useful commands

CommandWhat it does/ig-viralFinds recent popular content in your niche, ranked by how many times higher it performed than that account's usual posts/ig-carouselCarousel captions, including a cover that makes people want to swipe forward/ig-storyDaily Story order and which sticker to use/ig-profileScores your profile out of 100 and starts with what to fix first/ig-comment / /ig-replyWrite comments on others' posts / reply to comments on your own posts/ig-dmDMs, partnership outreach, and two follow-ups/ig-repurposeBreaks one long video, podcast, or article into a week of content/ig-auditReviews content you've already posted

/ig-viral requires you to look at those accounts in your own browser and hand the data to it. It doesn't log into your account or scrape in bulk.

Notes

Hook scoring can filter out weak hooks, but it can't pick out viral ones. The author tested it on 74 real short-video openings: it identifies deliberately weak openings well, but distinguishing viral videos from ordinary ones by the same creator is about as good as a coin flip. Use scoring to drop obvious weak hooks, then check your own completion data.
It won't post for you. Every result is text you can copy, and you check it yourself before posting on Instagram.
Platform rules change. Numbers such as hashtag limits follow Instagram's actual rules at the time.
Keep numbers real. When you see {{your number}}, fill in real data rather than letting the AI make it up.

Want it easier

This site has an Instagram Content Helper Skill. Once installed, you can just say "help me write a Reel," and it will check whether this package is installed and whether your voice guide is written, pick the right command, and follow the rules of not posting and not inventing data.