Ak Dev New Messaging Integration
yaalalabs/agent-kernel
Step-by-step guide for adding a new messaging platform integration to Agent Kernel.
How to use Instagram CLI to interact with Instagram from the command line on behalf of a user.
Install Instagram Skill
$ npx skills add supreme-gg-gg/instagram-cli --skill instagram-skill -a claude-codeProject install by default; add -g for ~/.claude/skills/.
$ gh skill install supreme-gg-gg/instagram-cli instagram-skill --agent claude-codeProject scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).
$ git clone --depth 1 https://github.com/supreme-gg-gg/instagram-cli.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/instagram-skill .claude/skills/instagram-skill && rm -rf skills-srcUse ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.
Claude Code skills documentation · loads skills from .claude/skills/
Install the "instagram-skill" agent skill from https://github.com/supreme-gg-gg/instagram-cli/tree/main/skills/instagram-skill into .claude/skills/instagram-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "instagram-skill", then confirm the skill loads.Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$skill-installer install https://github.com/supreme-gg-gg/instagram-cli/tree/main/skills/instagram-skillType this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.
$ npx skills add supreme-gg-gg/instagram-cli --skill instagram-skill -a codexProject install goes to .agents/skills/; add -g for ~/.codex/skills/.
$ gh skill install supreme-gg-gg/instagram-cli instagram-skill --agent codexProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/supreme-gg-gg/instagram-cli.git skills-src && mkdir -p .agents/skills && cp -r skills-src/skills/instagram-skill .agents/skills/instagram-skill && rm -rf skills-srcUse ~/.agents/skills/ instead of .agents/skills for a personal install.
Codex skills documentation · loads skills from .agents/skills/
Install the "instagram-skill" agent skill from https://github.com/supreme-gg-gg/instagram-cli/tree/main/skills/instagram-skill into .agents/skills/instagram-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "instagram-skill", then confirm the skill loads.Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add supreme-gg-gg/instagram-cli --skill instagram-skill -a cursorProject install goes to .agents/skills/; add -g for ~/.cursor/skills/.
$ gh skill install supreme-gg-gg/instagram-cli instagram-skill --agent cursorProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/supreme-gg-gg/instagram-cli.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/skills/instagram-skill .cursor/skills/instagram-skill && rm -rf skills-srcUse ~/.cursor/skills/ instead of .cursor/skills for a personal install.
Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/
Install the "instagram-skill" agent skill from https://github.com/supreme-gg-gg/instagram-cli/tree/main/skills/instagram-skill into .cursor/skills/instagram-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "instagram-skill", then confirm the skill loads.Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gemini skills install https://github.com/supreme-gg-gg/instagram-cli.git --path skills/instagram-skill--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.
$ npx skills add supreme-gg-gg/instagram-cli --skill instagram-skill -a gemini-cliProject install goes to .agents/skills/; add -g for ~/.gemini/skills/.
$ gh skill install supreme-gg-gg/instagram-cli instagram-skill --agent gemini-cliProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/supreme-gg-gg/instagram-cli.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/skills/instagram-skill .gemini/skills/instagram-skill && rm -rf skills-srcUse ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.
Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/
Install the "instagram-skill" agent skill from https://github.com/supreme-gg-gg/instagram-cli/tree/main/skills/instagram-skill into .gemini/skills/instagram-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "instagram-skill", then confirm the skill loads.Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ gh skill install supreme-gg-gg/instagram-cli instagram-skillInstalls for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).
$ npx skills add supreme-gg-gg/instagram-cli --skill instagram-skill -a github-copilotProject install goes to .agents/skills/; add -g for ~/.copilot/skills/.
$ git clone --depth 1 https://github.com/supreme-gg-gg/instagram-cli.git skills-src && mkdir -p .github/skills && cp -r skills-src/skills/instagram-skill .github/skills/instagram-skill && rm -rf skills-srcUse ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.
GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/
Install the "instagram-skill" agent skill from https://github.com/supreme-gg-gg/instagram-cli/tree/main/skills/instagram-skill into .github/skills/instagram-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "instagram-skill", then confirm the skill loads.GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
$ npx skills add supreme-gg-gg/instagram-cli --skill instagram-skill -a opencodeOpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.
$ gh skill install supreme-gg-gg/instagram-cli instagram-skill --agent opencodeProject scope by default (.agents/skills/); add --scope user for a personal install.
$ git clone --depth 1 https://github.com/supreme-gg-gg/instagram-cli.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/skills/instagram-skill .opencode/skills/instagram-skill && rm -rf skills-srcUse ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.
OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/
Install the "instagram-skill" agent skill from https://github.com/supreme-gg-gg/instagram-cli/tree/main/skills/instagram-skill into .opencode/skills/instagram-skill/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "instagram-skill", then confirm the skill loads.OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.
Facts
- Skill name
instagram-skill- GitHub stars
- 2.2k
- Token cost
- ~1.4k tokens
- SKILL.md length
- 390 words
- Files
- 1
- Skills in repo
- 1
- Repo updated
- First seen
- Licence
- MIT
At a glance
How to use Instagram CLI to interact with Instagram from the command line on behalf of a user.
- Works in 3 steps: Thread ID (20+ digit number like… → Username — exact Instagram username… → Thread title — fuzzy search across inbox…
- The user wants to send
- SKILL.md covers Thread Resolution, JSON Output, Commands and Multi-Account Support, plus 2 more sections
- Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
What it does
Instagram Skill is an agent skill from supreme-gg-gg/instagram-cli. How to use Instagram CLI to interact with Instagram from the command line on behalf of a user. Use this skill whenever the user wants to send or read Instagram messages, check their inbox, reply to or unsend messages, or automate any Instagram DM workflow via the CLI. This includes tasks phrased as "message X on Instagram", "check my Instagram DMs", "send a photo to my friend", "read my unread Instagram threads", or any automation / scripting involving Instagram direct messages.
Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.
It sits in Productivity & Automation, covering Messaging and chat bots and Email management. It works with Instagram, React and TypeScript. The repository describes itself as: Instagram's CLI and TUI client -- The ultimate weapon against brainrot. The licence is MIT.
When your agent uses it
- The user wants to send
- Read Instagram messages
- Check their inbox
- Unsend messages
Example prompts
- “message X on Instagram”
- “check my Instagram DMs”
- “send a photo to my friend”
- “/instagram-skill”
Workflow steps
3 steps, taken from the first numbered list in SKILL.md.
- Thread ID (20+ digit number like 340282366920938463...) — direct, zero extra API calls
- Username — exact Instagram username (e.g. johndoe)
- Thread title — fuzzy search across inbox (e.g. "Book Club")
What it can do on your machine
Read from SKILL.md and the folder at commit 1323aa4. It shows what the files ask for, not the result of running them.
Tool permissions
Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.
From allowed-tools in the SKILL.md frontmatter.
Runs code
No scripts in the folder and no shell commands in SKILL.md (its code samples are bash and json).
From the folder's file list and the shell code blocks in SKILL.md.
Network
No URLs in SKILL.md.
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names no API keys, tokens, secrets or passwords.
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.
Context cost
Instagram Skill loads about 1.4k tokens when it runs. Until then it costs about 125 tokens; SKILL.md has 390 words of instructions outside code blocks.
Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.
Safety
Auto-check passed
The automated check found no risky patterns in SKILL.md.
Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.
SKILL.md
The full file from supreme-gg-gg/instagram-cli at commit 1323aa4, republished under its MIT licence (© supreme-gg-gg). 390 words, ~1,350 tokens.
Download SKILL.mdSave it as
.claude/skills/instagram-skill/SKILL.md (or your agent's skills folder).- name
- instagram-skill
- description
- How to use Instagram CLI to interact with Instagram from the command line on behalf of a user. Use this skill whenever the user wants to send or read Instagram messages, check their inbox, reply to or unsend messages, or automate any Instagram DM workflow via the CLI. This includes tasks phrased as "message X on Instagram", "check my Instagram DMs", "send a photo to my friend", "read my unread Instagram threads", or any automation / scripting involving Instagram direct messages.
Instagram CLI — Agent Usage Guide
Instagram CLI (instagram-cli) is a terminal client for Instagram. For agents, it exposes
one-turn commands that print to stdout and exit — perfect for scripting and tool-use.
All one-turn commands require the user to already be logged in (
instagram-cli auth login). If a command returns an auth error, prompt the user to log in first. Do not attempt to login using the CLI by yourself.
Thread Resolution
Every command that targets a thread accepts a <thread> argument resolved in this order:
- Thread ID (20+ digit number like
340282366920938463...) — direct, zero extra API calls - Username — exact Instagram username (e.g.
johndoe) - Thread title — fuzzy search across inbox (e.g.
"Book Club")
Best practice for multi-step workflows: call inbox --output json first to get thread IDs,
then pass those IDs directly to subsequent commands. This avoids redundant search API calls and
is more reliable than username/title matching.
JSON Output
All commands accept -o json / --output json. Responses follow this envelope:
{ "ok": true, "data": { ... } }
{ "ok": false, "error": "message" }Always use --output json when you need to parse results programmatically.
Commands
List inbox
instagram-cli inbox [--limit <n>] [--output json]Returns recent threads. Each thread includes: id, title, users, lastMessage, lastActivity, unread.
# Get 10 most recent threads as JSON
instagram-cli inbox --limit 10 --output jsonSearch threads
instagram-cli inbox --search <query> [--limit <n>] [--output json]Searches by both username and thread title, merging results by relevance score.
instagram-cli inbox --search "alice" --output jsonSend a message
instagram-cli send <thread> --text <message> [--output json]
instagram-cli send <thread> --file <path> [--type photo|video] [--output json]<thread> is a thread ID, username, or title. --text and --file are mutually exclusive.
Media type is auto-detected from extension; use --type to override.
instagram-cli send johndoe --text "Hey, are you free tonight?"
instagram-cli send 340282366920938463123456789 --text "Got it!"
instagram-cli send "Book Club" --file ./photo.jpg --output jsonShow full SKILL.md (160 more words)Show less
Read messages
instagram-cli read <thread> [--limit <n>] [--cursor <cursor>] [--mark-seen] [--output json]Returns messages newest-first. Use cursor from the previous response to paginate older messages.
Pass --mark-seen to mark the thread as read after fetching.
instagram-cli read johndoe --limit 20 --output json
instagram-cli read 340282366920938463123456789 --mark-seenEach message in JSON output includes: id, itemType, text, userId, username, timestamp, isOutgoing.
Download media from a message
instagram-cli read <thread> --message-id <id> --download <path> [--output json]Finds the message by ID (paginates up to --max-pages, default 10) and saves the media file.
The file extension is automatically inferred if not provided.
instagram-cli read johndoe --message-id 340282366... --download ./mediaReply to a message
instagram-cli reply <thread> --message-id <id> --text <text> [--output json]Sends a threaded reply to a specific message.
instagram-cli reply johndoe --message-id 340282366... --text "Totally agree!"Unsend a message
instagram-cli unsend <thread> --message-id <id> [--output json]instagram-cli unsend johndoe --message-id 340282366...Multi-Account Support
All commands accept -u <username> / --username <username> to target a specific logged-in account.
Omitting it uses the default account set via instagram-cli auth switch.
instagram-cli inbox -u myworkaccount --output json
instagram-cli send johndoe --text "Hi" -u mypersonalaccountTypical Agent Workflow
# 1. Get inbox to find the right thread
INBOX=$(instagram-cli inbox --output json --limit 20)
# Parse "id" fields from INBOX to find the target thread
# 2. Read recent messages (use thread ID for speed)
THREAD_ID="340282366920938463..."
instagram-cli read "$THREAD_ID" --limit 10 --output json
# 3. Reply or send
instagram-cli send "$THREAD_ID" --text "On my way!" --output json
# 4. Mark as seen
instagram-cli read "$THREAD_ID" --mark-seenError Handling
- Auth errors → user needs to run
instagram-cli auth login - "No thread found matching" → the username/title didn't resolve; try
inbox --searchfirst "ok": falsein JSON output → theerrorfield contains the reason- Rate limits / network errors are surfaced as error messages; retry with backoff if needed
© supreme-gg-gg, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file
Files
Just SKILL.md in skills/instagram-skill of supreme-gg-gg/instagram-cli.
Open the folder on GitHubat commit 1323aa4
Compare with similar skills
Instagram Skill next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.
| Skill | Stars | Used in | Tokens | Auto-check | Licence | Repo updated |
|---|---|---|---|---|---|---|
| Instagram Skill this skillsupreme-gg-gg/instagram-cli | 2.2k | — | ~1.4k | Automated safety check: Pass | MIT | |
| Ak Dev New Messaging Integrationyaalalabs/agent-kernel | 192 | — | ~4.6k | Automated safety check: Pass | Apache-2.0 | |
| Ak Add Integrationyaalalabs/agent-kernel | 192 | — | ~3.1k | Automated safety check: Pass | Apache-2.0 | |
| Finish Extensions Featuresenchabot-opensource/monorepo | 114 | — | ~554 | Automated safety check: Pass | GPL-3.0 | |
| Novu Inbox Integrationnovuhq/novu | 40k | — | ~5.2k | Automated safety check: Pass | Custom licence | |
| Slackhuangruiteng/CS-Notes | 4k | 10 repos | ~578 | Automated safety check: Pass | MIT |
Similar skills
Ak Add Integration
yaalalabs/agent-kernel
Add a messaging platform integration to an existing Agent Kernel project.
Finish Extensions Feature
senchabot-opensource/monorepo
A skill your agent uses when completing a new feature or making a user-facing change in the apps/extensions workspace to ensure no required files or configurations are forgotten.
Novu Inbox Integration
novuhq/novu
Integrate Novu's in-app notification inbox into web applications.
Slack
huangruiteng/CS-Notes
A skill your agent uses when you need to control Slack from Clawdbot via the slack tool, including reacting to messages or pinning/unpinning items in Slack channels or DMs.
Openloomi Connectors
melandlabs/openloomi
openloomi Connectors tools - manage the native 7 messaging integrations and pair with the composio skill for the 1000+ apps OAuth layer (Slack, Discord, X, Gmail, Outlook, Google…
Related
Works with
Categories
Questions about Instagram Skill
What does Instagram Skill do?
How to use Instagram CLI to interact with Instagram from the command line on behalf of a user. Instagram Skill is an agent skill from supreme-gg-gg/instagram-cli. How to use Instagram CLI to interact with Instagram from the command line on behalf of a user.
When should I use Instagram Skill?
Instagram Skill fits situations like: the user wants to send; read Instagram messages; check their inbox; unsend messages.
How do I install Instagram Skill in Claude Code?
Run `npx skills add supreme-gg-gg/instagram-cli --skill instagram-skill -a claude-code`. Or copy the skill folder (skills/instagram-skill in supreme-gg-gg/instagram-cli) into .claude/skills/instagram-skill in your project. Claude Code loads it when a task matches its description.
How do I install Instagram Skill in Codex?
Run `npx skills add supreme-gg-gg/instagram-cli --skill instagram-skill -a codex`. Or copy the skill folder (skills/instagram-skill in supreme-gg-gg/instagram-cli) into .agents/skills/instagram-skill in your project. Codex loads it when a task matches its description.
Can I use Instagram Skill in Cursor, Gemini CLI or GitHub Copilot?
Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add supreme-gg-gg/instagram-cli --skill instagram-skill -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/instagram-skill, .gemini/skills/instagram-skill, .github/skills/instagram-skill and .opencode/skills/instagram-skill in your project.
What does Instagram Skill need to run?
SKILL.md names no scripts, command-line tools or credentials: Instagram Skill is instructions for the agent only.
Does Instagram Skill access the network?
SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.
Is Instagram Skill safe to install?
Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.
What licence does Instagram Skill use?
Instagram Skill is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.
How many tokens does Instagram Skill use?
About 1.4k tokens (SKILL.md is roughly 5.4k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.
What are the alternatives to Instagram Skill?
Skills that share tags, products or a category with Instagram Skill: Ak Dev New Messaging Integration (yaalalabs/agent-kernel, 192 stars), Ak Add Integration (yaalalabs/agent-kernel, 192 stars), Finish Extensions Feature (senchabot-opensource/monorepo, 114 stars) and Novu Inbox Integration (novuhq/novu, 40k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.
Who maintains Instagram Skill?
supreme-gg-gg (a GitHub user) maintains it in supreme-gg-gg/instagram-cli, which has 2,171 GitHub stars. The repository was last updated on October 10, 2026.
Source: supreme-gg-gg/instagram-cli on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.