walid@portfolio:~/lab/instagram-agent-skill$
cd../lab
03ideaOct 2026

Thirteen Claude skills that run an Instagram account

A free, open-source skill pack that writes your Reels, captions, carousels, replies and DMs in your own voice once you give it your voice profile, scores your profile and finds what is working in your niche, then leaves the posting to you. The full setup for the Claude app and Claude Code, every prompt, and what each skill really does, checked against the pack’s own code, Anthropic’s docs and Instagram’s help pages

Thirteen free Claude skills for running an Instagram account. /ig-reel turns one idea into three scored hooks, a script and a timed beat sheet. /ig-viral ranks the Reels in your niche by how far each one beat its own account. /ig-human strips the stock AI phrasing before anything goes out. Nothing is posted unless you post it. The checks kept the workflow and fixed the setup. Pasting the link only installs it in Claude Code, not the Claude app; the manual install command needed a fix; only two skills read your voice profile on their own; and cleaning up a caption doesn’t change whether Instagram labels a video as AI.

Claude skillsClaude CodeInstagramReelsPluginsThe skill pack on GitHub (MIT) ↗The voice.md template ↗Adding plugins in the Claude app ↗Using skills in the Claude app ↗Skills in Claude Code ↗Plugins in Claude Code ↗Seedance 2.5 (ByteDance) ↗Gemini Omni (Google) ↗Instagram’s AI labels ↗Meta Business Suite automations ↗Making the clips free on your own computer, in the Lab ↗
i
What this is

A pack of 13 skills you add to Claude, each one a job in running an Instagram account: Reels, captions, carousels, Stories, your profile, a weekly plan, comments, replies, DMs, repurposing, post-mortems, finding what is working in your niche, and a humanizer that cleans every draft. They write; you post. Claude never logs in to Instagram and the skills never publish anything; even when /ig-viral browses with you, it only reads. Where the original guide got something wrong, it’s fixed and marked where it applies.

Checked, not copied

What held up, on 15 October 2026

Checked against the skill pack’s own files (latest change 13 September 2026), Anthropic’s docs for the Claude app and Claude Code, Instagram’s and Meta’s help pages, and the video model makers’ pages.

ClaimWhat the sources say
“Free, open-source (MIT)”Confirmed. 13 skills plus six small Python scripts that use only Python’s standard library: no network calls, no API keys, nothing uploaded. About 1,400 stars on GitHub. The pack is free; Claude Code isn’t: it needs a paid Claude plan (Pro or above) or a pay-as-you-go Console account.
“Open a new chat in Claude and paste the GitHub link”Only in Claude Code, where Claude can clone the repository and copy the skills for you. Pasting the link into a chat in the app doesn’t install it: you add the pack under Customize, Plugins. Pasting the link in the app gets you no /ig- commands.
The two Claude Code install commandsOnly the manual copy needed a fix. The guide’s /plugin install instagram-agent works: it opens the plugin in the /plugin panel, which asks where to install it. The full name, instagram-agent@instagram-agent-skill, is the form Anthropic’s install steps use: it avoids a clash if another marketplace has a plugin with the same name, and it refreshes the marketplace before installing. The manual copy fails on a computer that has never had a personal skill, because the folder doesn’t exist yet; one extra line creates it.
“Every skill in the pack reads one file: voice.md”Only /ig-reel and /ig-plan read it on their own. And no install puts the template where the skills look: it stays at templates/voice.md inside the pack, and on a fresh install ~/.claude/instagram doesn’t exist yet.
/ig-viral ranks by “each account’s own average” and “doesn’t scrape anything”It measures against the median of the account’s last 12 Reels, not the average. It never scrapes or logs in for you, but if your Claude has a browser tool it can look through Instagram with you, in your own signed-in browser. Otherwise you paste in what you find.
/ig-reply sorts into “keyword / lead / question / support”Six groups, not four: keyword, lead, substance, question, support and noise. It answers the ones worth answering and leaves the noise.
“The 125 characters the feed actually displays”An approximation, and the skill’s own code says so: where the feed cuts moves with the phone, the font size and your line breaks. 125 is Meta’s guideline for ad text, not a rule for posts.
/ig-human removes “invisible characters that flag content as generated”It does remove them, but that isn’t how Instagram labels AI. Its labels come from markers inside the image or video file, or from you adding the label. If your Reel uses realistic AI video or a realistic AI voice, Meta requires you to add it.
“Seedance 2.5 / Omni Flash” in Vosu AIBoth are real. Seedance 2.5 is ByteDance’s, with sound and up to 30 seconds a clip; “Omni Flash” is Google’s Gemini Omni Flash. Vosu AI is a paid third-party site that resells both among many models; the makers offer them directly too.
“The skill never posts for you”Confirmed. No skill posts, likes, follows or messages anything, and nothing in the pack uses an Instagram API. /ig-viral can read Instagram through your own signed-in browser if your Claude has a browser tool. You make the video, copy your comments and stats in, and post everything yourself.
What you’ll learn

Your whole content workflow, inside Claude

How to install the Instagram Agent Skill in Claude and use its skills to run your content: writing posts, handling comments and replies, improving your profile, planning your week, and, the best one, finding the Reels in your niche that beat their own account’s usual numbers by the widest margin, breaking down why they worked and turning them into original scripts for you. (The guide calls them “the best-performing Reels”; the skill ranks each one against its own account, not by raw views.)

Tools used

What you need

1

Claude

The Claude app (claude.ai, the desktop app or your phone) or Claude Code in your terminal; this is where the skills run. Claude Code needs a paid Claude plan (Pro or above) or a Console (API) account. For the app, Anthropic’s help pages say skills work on every plan including Free, while its product docs list only the paid plans. Either way, turn on Code execution and file creation in Settings, Capabilities: the hook scorer, beat timer, caption checker and humanizer are scripts. (Not in the guide.)

2

The Instagram Agent Skill

Free and open source (MIT). For Claude Code you also need git, and Python 3 with no extra packages. On Windows the command may be python or py rather than python3.

3

Your Instagram account

A public or professional account, so you have Insights. You copy your comments and stats in, and you post what Claude writes; Claude never signs in. (The guide lists it “to read your own comments and stats”; you read them, Claude doesn’t.)

4

A video model for the visuals

The guide makes the Reels with Seedance 2.5 or Gemini Omni Flash through Vosu AI, a paid reseller. You can use either from its maker too (links at the top). This step is the guide’s addition: the skill pack assumes you film yourself.

i
The trick

Install the skill → set your voice → run the skills → post what you approve. Follow one step at a time, in order. Steps 1 and 2 are a one-time setup, and Steps 3 to 8 are the routine. The guide calls the routine weekly; the skills set their own rhythm: /ig-plan once a week, the writing skills for every post, a comment round each day, /ig-viral once a month, /ig-audit and /ig-profile now and then. Claude does the writing and the analysis; you film, copy in your comments and stats, and post. (The guide says everything happens inside Claude except the posting.)

Step 1

Install the pack: in the Claude app

Pasting the link into a chat doesn’t install the pack in the app. Add the pack once and it works in every chat on the web, desktop and phone. This route is from Anthropic’s docs and wasn’t run end to end here. (The guide says to paste the GitHub link into a new chat.)

1

Turn on code execution

Settings, Capabilities, then switch on Code execution and file creation.

2

Add the marketplace

Customize, Plugins, Add, Add marketplace, then type Jakeschincariol/instagram-agent-skill.

3

Add the plugin

Pick instagram-agent from it. Anthropic doesn’t review plugins added this way, so it’s worth reading the files first; this one holds only the 13 skills, with no hooks or servers.

4

Use a skill

Type / in the message box and pick ig-reel (listed under instagram-agent), or just ask, for example “write a Reel script about X”. The /ig- prompts further down are written for Claude Code; in the app, pick the skill from the menu and paste the rest.

Fallback: upload each skill folder as its own ZIP under Customize, Skills. That’s 13 uploads. /ig-viral borrows its formula names and hook scores from /ig-reel’s folder, so if the app doesn’t keep the two folders side by side it ranks the Reels without them; that wasn’t tested here, by either route.

Install the pack: in Claude Code

Paste this into Claude Code and it clones the repository and copies the skills, asking before each command. It needs git. If /ig-reel doesn’t show up afterwards, run /reload-skills. (The guide offers this paste for the Claude app; it only works here.)

install-prompt3 lines
https://github.com/Jakeschincariol/instagram-agent-skill

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

Or install it as a plugin, in a terminal session of Claude Code. Send the two commands one at a time, not pasted together: this one first, then wait for “Successfully added marketplace”.

plugin-add-marketplace1 lines
/plugin marketplace add Jakeschincariol/instagram-agent-skill

Then this one. It opens a panel: choose Install for you (user scope). The skills then show as /instagram-agent:ig-reel and so on, and the short /ig-reel works too unless another command already has that name. (The guide’s second command is /plugin install instagram-agent, without the @instagram-agent-skill. That works too right after you add the marketplace. The full name also rules out a clash with another marketplace’s plugin, and it refreshes the marketplace before installing, so use it when you reinstall for updates.)

plugin-install1 lines
/plugin install instagram-agent@instagram-agent-skill

Or copy the skills in yourself, in a Mac or Linux terminal. (The mkdir line is added. Without it the copy fails on a computer that has never had a personal skill.)

manual-install-mac3 lines
git clone https://github.com/Jakeschincariol/instagram-agent-skill.git
mkdir -p ~/.claude/skills
cp -r instagram-agent-skill/skills/ig-* ~/.claude/skills/

The same on Windows, in PowerShell. Not in the guide.

manual-install-windows3 lines
git clone https://github.com/Jakeschincariol/instagram-agent-skill.git
New-Item -ItemType Directory -Force -Path "$HOME\.claude\skills" | Out-Null
Copy-Item -Recurse -Force -Path .\instagram-agent-skill\skills\ig-* -Destination "$HOME\.claude\skills\"
i
Pick one route

A plugin and a manual copy both load if you do both, and they update differently. A plugin you add in the Claude app also reaches Claude Code by itself the next time you start it signed in to the same account, so don’t install it there again. The plugin is pinned to version 1.0.0, so to pick up later fixes, reinstall it. A manual copy updates with git pull and a fresh copy. Not in the guide.

The full pack

The 13 skills, and what the code says they do

The guide bolds the skills its companion reel calls out. The reel isn’t part of the guide and all 13 are bolded, so here they are side by side, each checked against its own instructions and scripts.

SkillWhat it doesChecked
/ig-reelWhat it doesOne idea into a Reel: three scored hooks from 26 formulas, the script, the on-screen text and a timed beat sheet.CheckedConfirmed: 26 formulas, and two small scripts score the hooks and time each line at 165 words a minute. The author’s own test says the score is good at catching weak hooks but can’t tell which of two good ones will do better.
/ig-viralWhat it doesThe virality skill: finds what is working in your niche and ranks it by how far each Reel went above its own account’s usual numbers.CheckedIt measures against the median of the account’s last 12 Reels, not its average (the guide says average). It names the hook formula for about half of real hooks and flags the rest for you to read.
/ig-captionWhat it doesWrites the caption and shows you roughly the first 125 characters, about what the feed shows before the “more” tap.CheckedThe 125 is approximate (the guide says it’s exactly what the feed displays). It also checks length (2,200 at most), the hook, one call to action, links, and hashtags, capped at five, Instagram’s limit since December 2025.
/ig-carouselWhat it doesSwipe posts: the cover that earns the swipe, the slide copy and the 1080x1350 files.CheckedThe pack has no image maker of its own. If your Claude can run code, it builds the slides as a web page that you export to PNG or JPG; in a plain chat you get the copy and the sizes. 1080x1350 (4:5) works everywhere, and the app now also takes 1080x1440 (3:4). Up to 20 slides.
/ig-storyWhat it doesThe daily Story sequence, which sticker does which job, and the DM funnel.CheckedConfirmed: 3 to 7 frames a day with one sticker ask, seven stickers matched to jobs, and a funnel where people answer a poll or question first and then you reply.
/ig-profileWhat it doesScores your profile against a 12-part rubric out of 100, then rewrites it in fix-first order.CheckedConfirmed: 12 parts adding up to 100, rewritten biggest loss first. You make the edits in Instagram yourself.
/ig-planWhat it doesPlans your week: what to post, which format, when, and the 10 accounts to engage with.CheckedIt doesn’t find the accounts: you give it ten and it splits them into 5 for reach, 3 peers and 2 buyers, for 20 minutes a day. It saves the plan to ~/.claude/instagram/plan.md; the skill says that’s for the other skills, but none of them reads it.
/ig-humanWhat it doesThe humanizer: strips AI-sounding words and invisible characters so the copy reads like you.CheckedConfirmed: 154 stock words and phrases, 18 kinds of invisible character, em dashes and curly quotes. Tells in the sentence shapes come back flagged for you to rewrite.
/ig-commentWhat it doesComments on other people’s posts: nine types, picked by what the post actually is.CheckedConfirmed. It gives two options of different types and says which one to post.
/ig-replyWhat it doesHandles the thread under your own post and sorts the replies into groups.CheckedSix groups: keyword, lead, substance, question, support and noise. (The guide lists keyword / lead / question / support.)
/ig-dmWhat it doesThe keyword delivery DM, the first message, the collab pitch and two follow-ups.CheckedConfirmed: follow-ups after 4 and 10 days, then it stops. It won’t write a cold message without a reason to send one.
/ig-repurposeWhat it doesOne video, podcast or newsletter into a week of Reels and carousels.CheckedConfirmed. Paste the transcript, unless your Claude has a transcript tool.
/ig-auditWhat it doesA post-mortem on what you already posted, ranked by outlier multiple.CheckedRanked by outlier multiple and by sends (shares by DM) per reach, from the Insights you paste or screenshot; it can’t see your account.
Step 2

Set up your voice profile

Ten minutes here is what makes every post sound like you and not like AI. Your voice profile is one file, voice.md, at ~/.claude/instagram/voice.md. /ig-reel and /ig-plan read it on their own; with the others, mention it or attach it. (The guide says every skill reads it.)

Get the template there with the command below and fill it in. Or skip the typing: paste the transcripts or captions of three of your Reels, the ones that sound most like you, and let Claude write it with the prompt below. (The guide says your three best; the template asks for the three that sound most like you.)

Downloads the template from GitHub, whichever way you installed. Mac or Linux. (The guide says to copy templates/voice.md from the skill folder. That works from a cloned copy once ~/.claude/instagram exists, but no install puts the file there and the app gives you no folder to copy from, so this downloads it.)

voice-template-mac2 lines
mkdir -p ~/.claude/instagram
curl -L -o ~/.claude/instagram/voice.md https://raw.githubusercontent.com/Jakeschincariol/instagram-agent-skill/main/templates/voice.md

The same on Windows, in PowerShell. Not in the guide.

voice-template-windows2 lines
New-Item -ItemType Directory -Force -Path "$HOME\.claude\instagram" | Out-Null
Invoke-WebRequest -Uri https://raw.githubusercontent.com/Jakeschincariol/instagram-agent-skill/main/templates/voice.md -OutFile "$HOME\.claude\instagram\voice.md"

(The guide’s prompt ends “Save it as my Instagram voice profile”, which names no file; this is the path the skills read.)

voice-prompt3 lines
Here are three of my own Reels. Write my voice.md from these — my tone,
sentence length, the words I always use, the words I never use, and who
I'm talking to. Save it to ~/.claude/instagram/voice.md.
i
Two things to fill in by hand

The template’s Proof section: real numbers and stories you’re happy to put your name on. The skills never invent one, so if it’s empty every draft comes back with {{your number}} in it. And in the Claude app there’s no documented place for the file to stay between chats, so keep voice.md on your computer and attach it, or add it to a Project. Not in the guide.

Step 3

Write your posts

One idea in, a finished Reel script, caption or carousel out. Give /ig-reel one idea. It writes three hooks, scores them, shows you the ranking and writes a full script on the top one, with the on-screen text and a beat sheet. If even the best hook scores under 50, it tells you that you don’t have a hook yet. It also wants one specific true thing, a result or a number, and won’t make one up, so with an idea like this one expect a question first.

ig-reel-prompt4 lines
/ig-reel My idea: most people use AI video tools wrong — they write one
long prompt instead of building the shot in layers. Target length 30
seconds. Audience: creators who want to make AI content that looks
cinematic.

Then run /ig-caption on the same idea, or /ig-carousel if the idea works better as a swipe post. For a Reel, the caption’s first line is the ask, not a second hook. Here “Keyword” means search terms: phrases someone would type to find you. The CTA word is separate, one word you also say in the video.

ig-caption-prompt2 lines
/ig-caption Write the caption for that Reel. Keyword: AI video.
CTA: comment "GUIDE".
Step 4

Handle comments and replies

Two skills: one for other people’s posts, one for the thread under yours. /ig-reply takes the comments under your own post, sorts them into its six groups and drafts replies for the ones worth answering. /ig-comment writes comments for posts from accounts in your niche. (The guide says /ig-reply sorts them into keyword / lead / question / support and drafts a reply for each.)

ig-reply-prompt2 lines
/ig-reply Here are the comments under my latest Reel: [paste comments].
My CTA was "comment GUIDE". Sort them and draft the replies.

(The guide asks /ig-reply for this DM in the same prompt; the delivery DM is /ig-dm’s job.)

ig-dm-prompt2 lines
/ig-dm Write the DM that delivers the guide link to everyone who
commented GUIDE. The link: [your link].

Paste the caption or attach a screenshot, with the account’s name; a description alone gives it less to go on. You get two options of different types and which one to post.

ig-comment-prompt2 lines
/ig-comment Write a comment for this post: [paste post caption or description].
Make it something the creator would actually pin.
i
Sending the keyword DM

Claude writes the DM; sending it is up to you. Do it by hand, or automate it with Meta Business Suite’s free Comment to message automation (Inbox, Automations, on a computer) or another tool built on Meta’s official messaging API. Automated replies need a professional account, send one message per comment within 7 days of it, and can continue only if the person replies. Never use a bot that signs in as you: Instagram’s terms forbid it. Not in the guide.

Step 5

Improve your profile

Paste your current name, handle, bio, link and highlights. You get a score out of 100, then the rewrite, biggest loss first, so you fix what actually costs you follows. Attach a screenshot of the top of your profile and your first two rows of posts as well: from text alone it can’t score your pinned posts, grid, photo, contact details, recent activity or Stories, 46 of the 100 points. Not in the guide.

ig-profile-prompt3 lines
/ig-profile Name: [your name]. Handle: @[handle]. Bio: [paste bio].
Link: [your link]. Highlights: [list]. Niche: AI video and content
creation. Goal: more profile visits turning into follows.
Step 6

Plan your week

Run /ig-plan once a week. It gives you what to post each day, in which format (Reel, carousel, Story), when, and a daily engagement list built from the ten accounts you give it, so your comments get seen. (The guide says it gives you the 10 accounts. The last two sentences of the prompt are added. Until it finds your voice.md, swipe file and log, /ig-plan asks four things before it plans: what you sell and to whom, your three or four themes, what happened this week, and ten accounts to be visible to. The prompt answers the last two, so it may still ask the first two. It aims for four to five posts a week, at least three of them Reels, so it may suggest dropping one.)

ig-plan-prompt4 lines
/ig-plan Plan next week for me. I can post 4 Reels and 2 carousels.
Best days for my audience are Tuesday to Saturday. Main theme this
week: Claude skills for creators. What happened this week: [a result,
a mistake or a number]. Ten accounts to engage with: [list them].
Step 7

Find what’s going viral in your niche

The virality skill, the one that makes the whole pack worth it. /ig-viral doesn’t scrape: you browse your niche as normal and hand it what you find, or, if your Claude has a browser tool, it can look with you in your own signed-in browser. It never signs in for you and won’t like, follow or message anyone. (The guide says you always hand it the data.)

For each Reel it needs the account, its followers, the account’s median views over its last 12 Reels, the Reel’s views and its opening line. It ranks every Reel by its outlier multiple, its views divided by that median: above 3x is a signal, under 1.5x is a normal day. Then it names the hook formula where it can, shows what the top third have in common that the bottom third don’t, and writes your own versions of the top formulas. Run it about once a month; formulas last a season. (The guide says you hand it the reel link, the hook, the views and the account’s usual numbers, that it ranks against the account’s average, and that it tells you why each one worked. It uses the median, doesn’t need the link, and reports what the top third share rather than a reason for each Reel.)

(The guide’s prompt gives 8 Reels with each account’s “typical views”. The skill wants six or more accounts and about a dozen Reels each, measured against each account’s median, and it warns that a small sample proves little: “Forty reels across six accounts supports a claim. Twelve does not.”)

ig-viral-prompt5 lines
/ig-viral Here are Reels from my niche (AI video creators), about a
dozen from each of six accounts, with the account, its followers, its
median views over its last 12 Reels, each Reel's views and its hook:
[paste list]. Rank them by outlier multiple, break down why the top
three worked, and pull out the hook formulas.

Then turn the winner into your own script.

viral-to-script-prompt3 lines
Now take the top formula and use /ig-reel to turn it into an original
script for me on this topic: [your topic]. Do not copy the reference —
same structure, my angle, my voice.
Step 8

Humanize, produce and post

Clean the copy, make the visuals, then you press post. The writing skills already run /ig-human on their drafts; run it yourself on anything you write or edit by hand. It removes the stock AI phrases and stray invisible characters so the copy reads like you. (The guide says to run every caption and script through it yourself; the writing skills already do that. It also says those phrases and characters are what “flag content as generated”. They aren’t: Instagram’s AI labels come from markers in the image or video file, or from your own label.)

ig-human-prompt2 lines
/ig-human Humanize this caption and show me what you changed:
[paste caption].

Then build the visuals. The guide pastes the Reel script into Vosu AI and uses Seedance 2.5 for the B-roll and hooks, or Gemini Omni Flash for quick talking-head clips; which model suits which shot is its tip, not the makers’.

Both models are also available from their makers: Seedance 2.5 in ByteDance’s Dreamina, up to 30 seconds a clip with sound, and Gemini Omni Flash in the Gemini app, Google Flow and, free, YouTube Shorts. Or, if you have a strong NVIDIA graphics card, make the clips free on your own computer with LTX-2 (see the Lab entry linked at the top). Prompt them shot by shot from the beat sheet rather than pasting the whole script, and keep your on-screen text inside the safe zone /ig-reel gives you. Not in the guide.

Post it yourself. The skills never post for you, so nothing goes live that you didn’t approve. If the Reel uses realistic AI video or a realistic AI voiceover, switch on Add AI label when you post: Meta requires it. Not in the guide.

!
Before you run it

It writes its notes to ~/.claude/instagram/: your voice profile, the swipe file, the plan and a log. /ig-viral may drive your signed-in browser, and for YouTube Shorts it can call yt-dlp, a separate download tool, so read those permission prompts before you approve them. The humanizer deletes zero-width and other format characters, including the joiners inside combined emoji, the non-joiners Persian words use and the direction marks that keep mixed Arabic and English lines in order, so check emoji and right-to-left captions afterwards. Its word swaps are blind too (“hack” becomes “trick”), so delete any word you really use from slop.json in the ig-human folder. Not in the guide.

i
Output

A complete Instagram content system inside Claude: Reels, captions and carousels in your own voice once voice.md is set up, comments and replies handled, a profile rewrite you apply yourself and a fresh score to show the gain, a week planned in advance, and a stream of original scripts built from what is already working in your niche. You make the visuals, review everything, and post. (The guide promises “a profile that scores higher”; /ig-profile re-scores its own rewrite, but your profile only changes once you make the edits yourself, and the voice only holds once voice.md is filled in.)