Home
cd ../playbooks
Marketing & ContentBeginner

Instagram Agent Skill: 13 Modes for Reels, Captions and DMs

A pack of 13 Claude skills that write your Reels, captions, carousels, stories, comments and DMs in your own voice, score your hooks, and never post anything without your yes

10 minutes
By Jake SchincariolSource
#instagram#reels#social-media#content-creation#hooks#captions#carousel#dm#personal-brand

Most Instagram advice is a guess dressed up as a rule. This pack makes Claude work from your own voice file and your own numbers: it scores your hook before you shoot, shows you the 125 characters the feed actually displays before the "... more", and ranks competitor reels by how far each beat its own account instead of by raw views.

Who it's for: solo creators, freelancers and consultants building an audience, small-business owners running their own Instagram, social media managers, coaches, agency founders

Example

"Write a reel: we cut proposal time from 5 hours to 20 minutes with one template" → three hooks drawn from 26 formulas and scored, a spoken script in your voice, a separate on-screen text list inside the safe zone, a timed beat sheet with fixes, and a REEL READY receipt. You shoot it and post it yourself

CLAUDE.md Template

New here? 3-minute setup guide → | Already set up? Copy the template below.

Or install from your terminal:
npx ccplaybooks add instagram-agent-skill
# Instagram Agent Skill: 13 Modes for Running an Instagram Account

Use this when someone asks for help with Instagram: a Reel script or hook, a caption, a carousel, stories, a profile rewrite, a weekly plan, comments, replies, DMs, repurposing a long asset, or a post-mortem on what already worked. Also use it for "make this sound human" on any short text.

Source: https://github.com/Jakeschincariol/instagram-agent-skill (MIT, by Jake Schincariol). This template condenses the 13 skills into one file. The original repo also ships five small Python scorers (hook scorer, beat timer, caption linter, humanizer and detector, swipe-file ranker). They are not part of this template. If the user has the repo's scripts installed, run them. If not, do the same checks by hand using the rules below and say that you did.

## Ground rules (apply to every mode)

- **Nothing gets posted until the user says yes.** These modes write. The user posts. Never publish, comment, follow, like, DM or schedule anything on their behalf, and never use a browser tool to do any of that.
- **Never log into Instagram for the user and never ask for a password.** If a page needs a login, the user is the one already logged in.
- **No automation of engagement.** Automated posting, commenting, following and DMing violate Instagram's Terms of Use and get accounts action-blocked. The one supported exception is keyword auto-replies in DMs through Instagram's own tools or approved partners, and only after someone comments first.
- **Never fabricate.** No invented metrics, clients, revenue or outcomes under the user's name, not even as placeholders. If a draft needs a number the user hasn't given, leave `{{your number}}` in it and flag it.

Get new playbooks like this one

One email a week with new Claude Code workflows. Free, like everything here.

No spam. Unsubscribe anytime.

README.md

What This Does

Turns Claude into a working partner for an Instagram account. There are 13 modes, each one a separate skill in the original repo (MIT licensed, by Jake Schincariol):

Mode What it does
Reel One idea into a Reel: three scored hooks from 26 formulas, the spoken script, on-screen text, a timed beat sheet
Viral research Ranks reels in your niche by how far each beat its own account's median, names the hook formula, writes a swipe file
Caption Writes the caption and shows what the feed displays before "... more"
Carousel Cover, slide-by-slide copy, 1080x1350 files
Stories The daily sequence, which sticker does which job, the DM funnel
Profile Scores your profile out of 100 against a 12-part rubric, then rewrites it in fix-first order
Weekly plan What to post, which format, when, plus 10 accounts to engage with
Humanizer Strips em dashes, stock AI vocabulary and invisible characters, then scores the result
Comment Nine comment types, picked by what the post actually is
Reply Sorts the comments under your post into six buckets, then writes replies in value order
DM Keyword delivery, first message, collab pitch, two follow-ups
Repurpose One video, podcast or newsletter into a week of posts
Audit Post-mortem on what you already posted: what worked, why, what to stop

Nothing gets posted until you say yes. These modes write. You post. That's the design, not a setting.


Quick Start

Step 1: Create a Project Folder

mkdir -p ~/Documents/Instagram

Step 2: Download the Template

Click Download above, then:

mv ~/Downloads/CLAUDE.md ~/Documents/Instagram/

This single file contains all 13 modes. It's the lightweight route: Claude does the hook scoring, timing and linting by hand from the rules in the file.

Step 3: Start Working

cd ~/Documents/Instagram
claude

Say "write my voice.md from these" and paste three of your own reels or captions. Then try "make a reel about [your idea]" or "plan my week".


Want the Real Scoring Scripts? Install the Repo Instead

The original repo ships five small Python tools that the template can only imitate: a hook scorer, a beat timer, a caption linter, a humanizer plus detector, and a swipe-file ranker. They need no dependencies, make no network calls and upload nothing. To get them, install the skills themselves:

git clone https://github.com/Jakeschincariol/instagram-agent-skill.git
cp -r instagram-agent-skill/skills/ig-* ~/.claude/skills/

Or as a plugin inside Claude Code:

/plugin marketplace add Jakeschincariol/instagram-agent-skill
/plugin install instagram-agent

Then use the slash commands: /ig-reel, /ig-viral, /ig-caption, /ig-carousel, /ig-story, /ig-profile, /ig-plan, /ig-human, /ig-comment, /ig-reply, /ig-dm, /ig-repurpose, /ig-audit.

No Claude Code? Paste any single SKILL.md at the top of a chat and it runs as a mode, minus the Python tools.


Do This First: Your Voice File

Every mode reads ~/.claude/instagram/voice.md. Ten minutes here is the difference between scripts you shoot and scripts you rewrite, because on Instagram you have to say the words out loud. Cover:

  • who you are and exactly who you're talking to ("photographers charging under $2,000", not "creatives")
  • how you sound on camera, words you use and words you'd never say, whether you swear, whether you use emoji
  • three to five positions you hold that part of your audience doesn't
  • topics, names and claims that are off limits
  • real numbers and stories you're happy to put your name on (the modes never invent one, so an empty section means {{your number}} placeholders in every draft)
  • your keyword call to action, if you use one

Or skip the form: give Claude three of your own reels and say "write my voice.md from these".


How the Reel Mode Works

  1. Three hooks, not one. Different formulas from the set of 26 (Cost Confession, Nobody Tells You, Time Collapse, The Steal, The Receipt and so on), each with a spoken line and an on-screen line.
  2. Score them. Five checks: length, specificity, stakes, front-loading, address. If the best hook is weak, no amount of editing fixes it.
  3. Write the script on the winner, in plain spoken language.
  4. Time it at about 165 words per minute and fix every flag: a hook past 3 seconds, a beat over 4 seconds, a run of lines with nothing concrete, no loop back to the first line.
  5. Humanize it, then print the script, the timed on-screen list and a receipt.

Rules that make the difference: one idea per Reel, numbers over adjectives, no greeting or "in this video", the frame changes every beat, one ask at the end, and on-screen text of six words or fewer kept inside the safe zone.


Tips & Best Practices

  • Run viral research monthly, not daily. Formulas last a season. After it runs once, the Reel and plan modes work from your own evidence instead of the defaults.
  • Rank by outlier multiple, not views. A 2M-follower account getting 400k views had a quiet Tuesday. A 4k-follower account getting 400k found something copyable. Above 3x is a signal. Below 1.5x is that account's normal day.
  • Hashtags are labels, not a reach lever. Instagram capped them at five per post in December 2025. Put the phrase you want to be found for in the caption text, in a normal sentence.
  • Say the keyword out loud. A keyword call to action needs one word people can type, no spaces and no emoji, and it works best when you say it in the video as well.
  • Run the humanizer on everything short. Captions, comments, replies and DMs are short, so one stock phrase or em dash is proportionally louder there than in an essay.
  • Don't write three posts from one source in one sitting. Repurpose mode drafts one at a time on purpose, because batch drafts all sound the same.

Limitations

  • It doesn't post, schedule or connect to Instagram. Instagram's Content Publishing API needs a Meta developer app, a linked Page, a long-lived token and app review. Other automation tools that post, comment, follow or DM break Instagram's Terms of Use and get accounts action-blocked, so every mode ends with copy-ready text and you post it. The one supported exception is keyword auto-replies in DMs, through Instagram's own tools or approved partners, and only after someone comments first.
  • Viral research reads, it doesn't scrape. Ten accounts, about a dozen reels each, at human speed, with you driving your own browser. It never asks for your password and never logs in as you.
  • The hook scorer catches bad hooks, not winners. The author tested it on 74 real short-form hooks (YouTube Shorts, since Instagram view counts can't be collected without logging in). It separated deliberately bad hooks from real ones well (AUC 0.83) but barely separated a creator's hits from their misses (AUC 0.56, where 0.50 is a coin flip). Only the specificity check separated them meaningfully. Use it to kill weak hooks before you shoot, then trust your retention graph.
  • The "human score" is a local heuristic. It isn't GPTZero, Originality, Copyleaks, Winston or Turnitin, it doesn't call them, and it can't promise their verdicts. The invisible-character pass removes zero-width and format characters that survive copy-paste. It isn't a claim about defeating watermarking.
  • Platform numbers go stale. If anything here contradicts what Instagram is doing today, Instagram is right.

$Related Playbooks

Marketing & Content

Instaloader: Download and Archive Instagram Content

Use the open-source Instaloader tool to back up your own Instagram account or save public posts, stories, highlights, captions and metadata to a local folder, with Claude choosing the options

10 minutes
Intermediate
Marketing & Content

Instagram Post Downloader

Download Instagram posts, carousels, and Reel covers at full CDN resolution — no screenshots, no compression — with carousel slides stitched into a single PDF and support for batch downloading multiple URLs at once.

5 minutes
Beginner
Marketing & Content

Image Seo Audit

Audit image SEO.

15 minutes
Intermediate
Marketing & Content

Influencer Brief

Create influencer campaign briefs.

15 minutes
Intermediate
Marketing & Content

Influencer Creator

Plan influencer and creator partnerships.

15 minutes
Intermediate
Marketing & Content

Framework Extraction Engine

Extract 15-25 reusable fill-in-the-blank content frameworks from high-performing swipe file entries — each with structure templates, cross-niche examples, and usage notes.

5 minutes
Intermediate
Marketing & Content

Lead Magnets

Plan, design, and distribute lead magnets that capture qualified emails and lead naturally to product adoption.

10 minutes
Beginner
Marketing & Content

Journey Design

Design cross-channel customer journeys.

15 minutes
Intermediate
Marketing & Content

Keyword Research

Research and cluster keywords.

15 minutes
Intermediate
Marketing & Content

Landing Page Audit

Audit landing pages.

15 minutes
Intermediate
Marketing & Content

Language Audit

Audit multilingual content consistency.

15 minutes
Intermediate
Marketing & Content

Language Config

Configure language settings.

15 minutes
Intermediate

Browse all Marketing & Content playbooks →