Instacomp — Communication skill for Claude Code
Turn the posts shared in your Instagram chats and Saved into a searchable library (captions, transcripts, on-screen text), then ask Claude about it.
How to install Instacomp
This entry records only its repository, not the path inside it, so there is no
exact command to give. Open captkernel/instacomp and copy the folder into
~/.claude/skills/, or the file into ~/.claude/agents/.
What Instacomp does
Turn the posts shared in your Instagram chats and Saved into a searchable library (captions, transcripts, on-screen text), then ask Claude about it.
Alternatives in Communication
- HolaOS — Open-source agentic workspace enterprises can make their own 10.9k ★
- Hermes Bot Mode — Bot Mode for the Hermes desktop: a roster of named agents with their own chats, avatars, routines, and bot-to 650 ★
- NullMotion — Motion graphics preview and YouTube clip maker: finished ad over HyperFrames drafts, MP4 export, pause cuts, c 582 ★
README
instacomp
Pulls the text out of Instagram posts, reels and carousels you have shared or saved: caption, audio transcript and on-screen text. Everything lands in one SQLite library with Markdown and CSV exports.
Install & use (v0.2)
uv tool install "instacomp[deep] @ git+https://github.com/captkernel/instacomp"
No `uv`? `pipx install "instacomp[deep] @ git+https://github.com/captkernel/instacomp"` works too.
For local development: `pip install -e ".[deep,chrome,dev]"`.
Extras: `deep` adds faster-whisper (it also needs ffmpeg on PATH). `chrome` adds playwright, for the optional Chrome sync mode.
In Claude Code, install the plugin from the captKernel marketplace, then run `/instacomp:setup`:
/plugin marketplace add captkernel/plugins
/plugin install instacomp@captkernel
`/instacomp:setup` It walks you through the export below and the first import.
Get your Instagram export
Settings, Accounts Center, Your information and permissions, Download your information, Download or transfer information, your account, Some of your information. Tick **Messages** and **Saved**. Choose Download to device, set the date range, Format **JSON**, Media quality **Low**, then Create files. Instagram emails you when the ZIP is ready.
Library
The library lives in `~/.instacomp` (override with `INSTACOMP_HOME`): `library.db`, `media/`, `exports/`, `chrome_profile/`, `models/`.
CLI
Run `instacomp --help`. Every command takes `--json`.
| Command | What it does |
|---|---|
chats ZIP |
List the chats found in an export. |
import ZIP [--dm NAME]... [--saved-since YYYY-MM-DD] [--me NAME] |
Load DM threads and saved posts from the export. |
fetch [--limit N] |
Fetch captions logged-out. 1 to 3 s pacing, max 300 per run, stops after 5 refusals in a row. Rerun later. |
deep [--source S] |
For posts with a caption under 80 characters: download media, run Whisper, extract frames. |
load-ocr |
Load OCR text written by the ocr-reader agen |
Related Skills
Social Media Caption Generator Claude
Social media caption generator as a Claude skill — turn any text, script, or screenshot into ready-to-post cap
Post Threads
Publish multi-part text threads to Threads and X (Twitter) — split long-form ideas into a hook-first sequence
Sv Auto Learner
SV Auto Learner. Paste a YouTube link in Claude Code or Codex: it reads every word (captions or local Whisper
Add To Library
Add a new item to the HQ library. The user may provide a URL, a YouTube link, or paste raw text as an argument
Viral Hook Writer For Textheavy Formats
Claude Code skill that writes a batch of viral hooks for text-heavy short-form: on-screen text over one clip,
Team Update
Turn your daily logs into a short standup-format update, saved in team-updates/ and ready to paste into Slack,
Related Agents
Oppius
Meta (Facebook/Instagram) ads specialist for When in Rome. Use to turn existing photos, captions, and product
Social Media Copywriter
Social media content creation specialist. Use PROACTIVELY for creating Twitter threads, LinkedIn posts, and In
Content Engine
Writes posts, captions, reel and video scripts, and the weekly content calendar across Instagram, Facebook, Li