The free Instagram agent skill for Claude and ChatGPT
14 free agent skills that write Reels, captions, replies and DMs for your Instagram account. Connect PostZen and the same skills publish, reply and read analytics.
No credit card required.

https://github.com/postzen-dev/instagram-agent-skill Install this skill and the PostZen MCP server, then confirm /ig-reel works.
The 14 skills
Claude and ChatGPT skills for Instagram
Each skill is a slash command. Without PostZen, it writes and you post the result yourself. Connecting PostZen adds the account actions listed under each skill.
- /ig-reel
Write a Reel
Turns one idea into a Reel: scores three hooks from 26 hook formulas, then writes the script, on-screen text and a timed beat sheet.
With PostZen: Passes the finished video to /ig-publish.
Write a Reel
Turns one idea into a Reel: scores three hooks from 26 hook formulas, then writes the script, on-screen text and a timed beat sheet.
With PostZen: Passes the finished video to /ig-publish.
Setup guide
Set it up in five steps
Install the skills, sign in to PostZen, connect Instagram, fill in your voice file, then publish your first Reel. The full setup runs in Claude or Codex.
- 1
Install the skills
Choose one of the three routes below. The paste prompt works in Claude Code and Codex; the manual and plugin routes are for Claude Code.
Paste this prompt into Claude Code or Codex. The agent installs the skills and registers the PostZen MCP server.
Paste a prompthttps://github.com/postzen-dev/instagram-agent-skill Install this skill and the PostZen MCP server, then confirm /ig-reel works.
- 2
Sign in to PostZen
In Claude Code, run /mcp, select postzen and choose Authenticate. In Codex, run codex mcp login postzen. Then PostZen opens in your browser: sign in and choose Read & Write so the agent can publish.
Sign in to PostZen/mcp
Create a free accountNo credit card required. - 3
Connect your Instagram account
Say "connect my Instagram" and /ig-publish asks PostZen for a connect link. Your account must be a Business or Creator account, which Instagram calls "professional"; personal accounts cannot connect.
Connect your Instagram accountconnect my Instagram
- To switch, open Settings and activity > Account type and tools > Switch to professional account. Switching is free and reversible; a private account becomes public.
- If you sign in through Facebook, set an Instagram password first using Forgot password, or log in at instagram.com before opening the link.
- If the page stalls after login, log in at instagram.com in the same browser and open the link again.
- 4
Fill in your voice file
All 14 skills read ~/.instagram-agent/voice.md before writing. Copy templates/voice.md there and spend about ten minutes filling it in. You can also send Claude three of your own Reels and say "write my voice.md from these" to get a draft.
Fill in your voice filewrite my voice.md from these
- 5
Publish your first Reel
Ask for a Reel on a topic you know well. /ig-reel scores three hooks and writes the script and beat sheet. Record the video, then give it to /ig-publish. It shows the exact caption, account and time, waits for your approval, publishes, and checks the post status to confirm it went live.
- Every skill shows the content, account and time before anything is posted
- Ask for a draft or a scheduled time instead of publishing now
After install
What to say to your agent
Use the slash commands or describe what you need in plain language. These are the kinds of requests the skills are built for.
Write me a Reel about the three contract clauses freelancers skip. Score the hooks before you write the script.
Here are 20 Reels I saved from my niche this week. Rank them against each account’s usual numbers and build me a swipe file.
Write my voice.md from these three Reels, then rewrite yesterday’s caption in that voice.
Sort the comments on my last post and draft replies. Hide the spam, delete nothing.
Set up a comment-to-DM automation: anyone who comments GUIDE gets the link, but only if they follow me.
Turn this podcast episode into a week of posts, show me the schedule, and queue it once I approve.
Frequently asked questions
Still have questions?
Is the Instagram agent skill free?
The skills are. All 14 are open source under the MIT license, and PostZen’s free plan costs $0, covers 2 connected social accounts and 20 posts a month, and needs no credit card. What you bring is your own Claude or Codex access; the skills run inside whichever one you already use.
Will it post to Instagram without asking me?
No. Nothing gets posted until you say yes. Each skill shows the exact content, account and time first, and all publishing goes through /ig-publish. You can approve a single post or a whole week’s schedule. After publishing, /ig-publish reads the post status back to verify the post went live. Comment moderation hides comments rather than deleting them.
Which Instagram accounts can connect?
Instagram Business and Creator accounts, which Instagram calls professional accounts. Personal accounts cannot connect. Switching is free and reversible (Settings and activity > Account type and tools > Switch to professional account), but a private account becomes public when you switch.
Do I need Claude Code, or does the Claude app work?
Claude Code (or Codex) gets the full setup: all 14 skills installed, the Python tools that score hooks and check captions, and the PostZen MCP server. The Claude app cannot install skills from a chat, so it gets a lighter path. Add PostZen as a custom connector (Settings, then Connectors, then Add custom connector, URL https://mcp.postzen.dev/mcp, Connect, and pick Read & Write on the PostZen page), then paste a single SKILL.md at the top of a chat to use that skill as a mode. You lose the Python tools, but the writing works and publishing still waits for your approval.
Does it work with Codex or ChatGPT?
Codex is supported: paste the install prompt and sign in to PostZen with codex mcp login postzen. ChatGPT is not a tested route. What you can do there is paste a single SKILL.md at the top of a chat and use that skill as a writing mode, without the Python tools and without publishing.
Do I need PostZen to use the Claude Instagram skills?
Not for writing. Every skill produces copy you can post yourself, and you can paste a single SKILL.md into a Claude chat and use it as a mode. PostZen is required for anything that touches your account: publishing, scheduling, reading and answering comments, DMs, comment-to-DM automations and analytics.
Is this safe? Does it use the official Instagram API?
Yes. PostZen manages the Meta developer app, the app review and the tokens, so Claude uses Instagram’s official Content Publishing API. There is no scraping. PostZen generates the connect link; the page it opens is Instagram’s own login, which asks for your Instagram username and password, and Claude never sees them.
What does PostZen cost?
The Free plan is $0: 2 connected social accounts, 20 posts a month, no credit card. Paid plans start at $29 a month with Starter, which covers 5 accounts and unlimited posts. Comment-to-DM automations are included on every plan, including Free. Your Claude or Codex subscription is separate and billed by its own provider.
What is an Instagram AI agent, and is this one?
An Instagram AI agent is a model that takes actions on an account. On their own, these skills prepare content for you. With PostZen connected they act on the account as well: publishing posts, replying to comments and DMs, running comment-to-DM automations and reading analytics. Every publish still waits for your approval.
Give Claude an Instagram account to run
Create a free PostZen account and connect your Business or Creator account, and the 14 skills can act on it. Nothing posts until you say yes.