Agent skill

Instagram SEO

by social-media-skills in social-media-skills/skills

The Instagram SEO / keyword-search skill -- IG-specific search depth, distinct from the cross-cutting social-seo.

MITAuto-check passedMarketing & SEO

Install Instagram SEO

skills CLI
$ npx skills add social-media-skills/skills --skill instagram-seo -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install social-media-skills/skills instagram-seo --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/social-media-skills/skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/instagram-seo .claude/skills/instagram-seo && rm -rf skills-src

Use ~/.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/

Facts

Skill name
instagram-seo
GitHub stars
134
Token cost
~2k tokens
SKILL.md length
807 words
Files
6 (incl. references)
Skills in repo
106
Repo updated
First seen
Licence
MIT

At a glance

The Instagram SEO / keyword-search skill -- IG-specific search depth, distinct from the cross-cutting social-seo.

  • Works in 2 steps: brand-profile — niche/voice. → the post topic/destination.
  • Someone wants an Instagram post/Reel to rank in search
  • SKILL.md covers The POV: Instagram is a…, Read these first, The framework: MATCH and The reality (verify-quarterly), plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Instagram SEO is an agent skill from social-media-skills/skills. The Instagram SEO / keyword-search skill -- IG-specific search depth, distinct from the cross-cutting social-seo. Use when someone wants an Instagram post/Reel to rank in search, needs IG keyword research, or wants a searchable caption/profile. Instagram shifted from hashtag-based discovery to keyword-based search (hashtags deprioritized to 3-5 topic labels). Search runs semantic analysis - metadata matching - visual recognition (checks alt text + visual MATCH the caption). Uses the MATCH framework. Reads…

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. The skill folder holds 7 other files, including reference files (for example `evals/evals.json`, `references/instagram-seo-2026-reality.md` and `references/keyword-research-and-surfaces.md`).

It sits in Marketing & SEO, covering Keyword research. It works with Instagram and Pinterest. The repository describes itself as: 106 social media skills for AI agents - strategy, writing, video, design, platform growth, publishing, and analytics. Works with Claude, Cursor, OpenClaw, Hermes & 40+ agents. The licence is MIT.

When your agent uses it

  • Someone wants an Instagram post/Reel to rank in search
  • Needs IG keyword research
  • Wants a searchable caption/profile

Example prompts

  • “/instagram-seo”

Workflow steps

2 steps, taken from the first numbered list in SKILL.md.

  1. brand-profile — niche/voice.
  2. the post topic/destination.

What it can do on your machine

Read from SKILL.md and the folder at commit 6e30eeb. 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.

    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 SEO loads about 2k tokens when it runs, and up to ~5.4k if it reads all its reference files. Until then it costs about 248 tokens; SKILL.md has 807 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~248
When it runs · the whole SKILL.md, loaded when a task matches
~2k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.4k

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 social-media-skills/skills at commit 6e30eeb, republished under its MIT licence (© social-media-skills). 807 words, ~2,012 tokens.

Download SKILL.mdSave it as .claude/skills/instagram-seo/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
instagram-seo
description
The Instagram SEO / keyword-search skill -- IG-specific search depth, distinct from the cross-cutting social-seo. Use when someone wants an Instagram post/Reel to rank in search, needs IG keyword research, or wants a searchable caption/profile. Instagram shifted from hashtag-based discovery to keyword-based search (hashtags deprioritized to 3-5 topic labels). Search runs semantic analysis -> metadata matching -> visual recognition (checks alt text + visual MATCH the caption). Uses the MATCH framework. Reads brand-profile + the post's topic first. The agent researches the keyword cluster (never fabricates volume), writes the search-first caption (primary keyword first, no stuffing), specs on-screen text + spoken keyword, and advises profile fields/alt text. WoopSocial publishes the caption; profile fields, alt text, and IG Search/Insights stay native. No keyword stuffing; caption must match the visual. Distinct from social-seo, pinterest-seo, and hashtag-strategy.
version
1.0.0

instagram-seo

The IG keyword-search layer — research the queries and write the keyworded caption (and advise the profile labels + visual signals) that make a post rank in Instagram search. The agent researches + writes the search-first caption + specs the on-screen/spoken keyword + advises the profile/alt text; WoopSocial publishes the caption; the Name field, handle, bio, alt text, category, and auto-captions are native/ advised, and on-screen text/audio come from other tools/the creator.

The POV: Instagram is a keyword search engine — keywords replaced hashtags

Since late 2024 (official in 2026), IG shifted from hashtag-based discovery to keyword-based search — hashtags are deprioritized to 3–5 topic labels, and a large and growing share of discovery/new followers now starts from search (verify-quarterly; never quote a precise share). It's a closed system (no external crawl/backlinks) but Google + Bing index IG captions. Search runs semantic analysis → metadata matching (Name field/bio/caption keyword cluster) → visual recognition (Computer Vision checks the alt text + visual match the caption — a mismatch lowers ranking). WoopSocial publishes the caption; the profile labels, alt text, on-screen text, audio, and settings are native/ advised/other-tools. Pairs with caption-writer (the keyword goes in the searchable caption).

Read these first

  1. brand-profile — niche/voice.
  2. the post topic/destination.

The framework: MATCH

(Depth: references/the-match-framework.md.)

  • M — Mine the real queries: scan top Reels' captions/on-screen text + competitor Name fields + Google "People Also Ask"; build a 3–5 keyword cluster. Method only; never fabricate volume.
  • A — Anchor the caption to search: lead the first sentence / ~125 chars with the primary keyword (natural long-tail); weave the cluster; 3–5 hashtag labels — the publishable surface (content.text).
  • T — Tag the profile labels: Name field ("Name | Niche"), keyworded handle, indexable bio (niche/offer/ location/CTA). Profile-level — native/advised.
  • C — Confirm the visual matches: alt text + on-screen text + first-3-sec spoken keyword reinforce and match the caption (Computer Vision); auto-captions on; remove other-platform watermarks. On-screen → image/video tool; script → reels-script; alt text → native.
  • H — Harvest over time across search + Explore: search = keyword-driven, Explore = behaviour-driven; optimize for saves/shares/watch-time; compounds over 90–120 days; no stuffing / irrelevant tags.

The reality (verify-quarterly)

Keyword-based since late 2024 (official 2026); hashtags 3–5 labels; a growing share of discovery from search; closed system but Google/Bing index captions; 3-step search (semantic → metadata cluster → Computer Vision alt-text/ visual match); surfaces (Name field high weight, handle, indexable bio, search-first captions [primary keyword first sentence/125 chars, 150–300 words], alt text [must match], on-screen text transcribed, audio transcribed [first-3-sec keyword], auto-captions lift watch time + are indexed, category/location, 3–5 cluster); search vs Explore; engagement (saves/shares/watch-time/replays > likes; completion); Reels deprioritized (watermarks/ low-res); the Raw Content Revolution (human-made, retention/sends); research method + slow-burn timeline (2–4 wk / 30–60 day / 90–120 day): references/instagram-seo-2026-reality.md. The research method, the surface map (publishable vs native vs other-tools), the caption template, the must-match checklist, the publish block + worked examples: references/keyword-research-and-surfaces.md.

Show full SKILL.md (358 more words)Show less

Honest scope (never violate)

  • The agent researches keywords (advises the method, never fabricates volume), writes the search-first caption (content.text, primary keyword first, no stuffing, 3–5 hashtag labels), specs the on-screen text + first-3-sec spoken keyword, and advises Name field/handle/bio/alt text/category.
  • WoopSocial publishes the IG post's caption (POST/REEL/STORY via content.text).
  • WoopSocial does NOT: set Name field/handle/bio (profile — native), alt text (native/at-post), category/location (native), toggle auto-captions (native), read IG Search/Insights (native), render the on-screen text (image/video tool), or record the spoken audio (creator/reels-script).
  • No keyword stuffing (suppressed); no irrelevant hashtags (hurt credibility); the caption must MATCH the visual (Computer Vision — no misleading); remove other-platform watermarks; never fabricate volume or rankings. (Scope, distinctions + connections: references/scope-and-connections.md.)

Distinct from its siblings (route correctly)

instagram-seo (this) = IG-specific keyword search (Name field, closed-system + Google-indexed, Computer Vision caption-visual match, first-3-sec spoken keyword) · social-seo = the cross-cutting framework · pinterest-seo = Pinterest (boards/Trends/Rich Pins, an open web-indexed system) · hashtag-strategy = deprioritized to 3–5 (they pair: tags label, keywords discover) · caption-writer = the craft (pairs) · reels-script = the Reel script.

Where this connects

Reads first: brand-profile + the post topic. Pairs with: caption-writer (the caption), hashtag-strategy (the 3–5 labels), reels-script (the first-3-sec spoken keyword), ideogram/the video tools (the on-screen text overlay). Routes to/from: instagram-growth (the strategy), social-seo/ ai-search-optimization (the cross-platform + AI search picture), content-recycling (re-cut a winning Reel into a keyworded carousel). Publishes via: scheduling-and-queue → WoopSocial (the caption; POST/REEL/ STORY) + platform-specs-and-validation. Measures with: native IG Insights + analytics-and-reporting (profile visits from search, saves, non-follower reach). Profile, alt text, settings + IG Search stay native.

Definition of done

Real queries mined via top-Reel scans + competitor Name fields + Google "People Also Ask" into a 3–5 keyword cluster (method advised, no fabricated volume); a search-first caption with the primary keyword in the first sentence (natural long-tail, no stuffing, 3–5 hashtag labels) written as the publishable surface; the Name field ("Name | Niche"), handle, bio, and alt text advised; the on-screen text + first-3-sec spoken keyword specced (to reels-script + an image/video tool) and confirmed to MATCH the caption with auto-captions on and no watermark; the caption published via WoopSocial while profile/alt-text/category/auto-captions/IG-Search stay native; no keyword stuffing, no irrelevant tags, no caption-visual mismatch, nothing fabricated; correctly distinguished from social-seo and pinterest-seo and paired with caption-writer.

© social-media-skills, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (references) in skills/instagram-seo of social-media-skills/skills.

  • SKILL.md
  • evals/evals.json
  • references/instagram-seo-2026-reality.md
  • references/keyword-research-and-surfaces.md
  • references/scope-and-connections.md
  • references/the-match-framework.md

Open the folder on GitHubat commit 6e30eeb

Compare with similar skills

Instagram SEO 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.

Instagram SEO compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Instagram SEO this skillsocial-media-skills/skills134—~2kAutomated safety check: PassMIT
Google Maps Contact Extractbrowser-act/skills6.1k—~2.9kAutomated safety check: PassMIT
Trend DiscoveryScrapeCreators/social-media-research-skills3.4k—~789Automated safety check: NotesMIT
Google Social Media Finderbrowser-act/skills6.1k—~1.7kAutomated safety check: PassMIT
Happycapy Social Publisherhappycapy-ai/Happycapy-skills137—~3.6kAutomated safety check: NotesMIT
Ecommerce Content MarketingLeoYeAI/openclaw-master-skills2.2k1 repos~5.3kAutomated safety check: PassMIT

Similar skills

  • Google Maps Contact Extract

    browser-act/skills

    Extracts business contact details from Google Maps search results and place detail pages, then visits each business website to collect emails, phone numbers, and social media profiles (Facebook…

    6.1k GitHub stars~2.9k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Trend Discovery

    ScrapeCreators/social-media-research-skills

    A skill your agent uses when the user wants to discover trending social topics, hashtags, sounds, posts, reels, shorts, creators, or formats in a niche.

    3.4k GitHub stars~789 tokensUpdated 1 mo ago
    Marketing & SEOAuto-check: notes
  • Google Social Media Finder

    browser-act/skills

    Searches Google to discover social media profiles associated with a person, brand, or username; returns platform name, profile URL, username, bio snippet, and follower count across X, Instagram…

    6.1k GitHub stars~1.7k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check passed
  • Happycapy Social Publisher

    happycapy-ai/Happycapy-skills

    HappyCapy-specific skill for publishing content to 13+ social media platforms (Instagram, Twitter, LinkedIn, Threads, Facebook, TikTok, YouTube, Pinterest, Reddit, Telegram, Discord, etc.)…

    137 GitHub stars~3.6k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check: notes
  • Ecommerce Content Marketing

    LeoYeAI/openclaw-master-skills

    E-commerce content marketing strategy planner. An agent skill from LeoYeAI/openclaw-master-skills.

    2.2k GitHub starsUsed in 1 repo~5.3k tokens
    Writing & ContentAuto-check passed
  • Bulkpublish Social Scheduling

    davepoon/buildwithclaude

    Schedule, publish and analyze social posts across 15 networks via BulkPublish (MCP or REST) — Facebook, Instagram, X, TikTok, YouTube, Threads, Bluesky, Pinterest, Google Business, LinkedIn…

    3.6k GitHub stars~1.3k tokensUpdated 2 days ago
    Marketing & SEOAuto-check passed

More from social-media-skills/skills

All 106 skills in this repo
  • AI Image Editing

    social-media-skills/skills

    The AI image-editing router — inpainting/object removal, background removal, upscaling, outpainting, old-photo restoration, and retouch, routed task-first to the right engine.

    134 GitHub stars~2.1k tokensUpdated 9 days ago
    Auto-check passed
  • AI Music And Sound

    social-media-skills/skills

    The AI music + sound-design skill for social -- original/licensed audio beds and sound design for Reels/TikToks/Shorts/videos.

    134 GitHub stars~1.9k tokensUpdated 9 days ago
    Auto-check passed
  • AI Search Optimization

    social-media-skills/skills

    A skill your agent uses to get a brand and its content CITED and RECOMMENDED by AI answer engines — the GEO (Generative Engine Optimization) / AI-search-visibility skill.

    134 GitHub stars~2k tokensUpdated 9 days ago
    Auto-check passed
  • AI Video

    social-media-skills/skills

    The model-agnostic AI-video router and brief — the counterpart to image-prompt.

    134 GitHub stars~1.3k tokensUpdated 9 days ago
    Auto-check passed
  • AI Voiceover

    social-media-skills/skills

    The AI narration / voiceover mini-skill (ElevenLabs-led). An agent skill from social-media-skills/skills.

    134 GitHub stars~1.1k tokensUpdated 9 days ago
    Auto-check passed
  • Analytics And Reporting

    social-media-skills/skills

    Social media analytics and reporting — read native platform data honestly and turn it into next actions.

    134 GitHub stars~1.4k tokensUpdated 9 days ago
    Auto-check passed

Categories

Questions about Instagram SEO

What does Instagram SEO do?

The Instagram SEO / keyword-search skill -- IG-specific search depth, distinct from the cross-cutting social-seo. Instagram SEO is an agent skill from social-media-skills/skills. The Instagram SEO / keyword-search skill -- IG-specific search depth, distinct from the cross-cutting social-seo.

When should I use Instagram SEO?

Instagram SEO fits situations like: someone wants an Instagram post/Reel to rank in search; needs IG keyword research; wants a searchable caption/profile.

How do I install Instagram SEO in Claude Code?

Run `npx skills add social-media-skills/skills --skill instagram-seo -a claude-code`. Or copy the skill folder (skills/instagram-seo in social-media-skills/skills) into .claude/skills/instagram-seo in your project. Claude Code loads it when a task matches its description.

How do I install Instagram SEO in Codex?

Run `npx skills add social-media-skills/skills --skill instagram-seo -a codex`. Or copy the skill folder (skills/instagram-seo in social-media-skills/skills) into .agents/skills/instagram-seo in your project. Codex loads it when a task matches its description.

Can I use Instagram SEO 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 social-media-skills/skills --skill instagram-seo -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-seo, .gemini/skills/instagram-seo, .github/skills/instagram-seo and .opencode/skills/instagram-seo in your project.

What does Instagram SEO need to run?

SKILL.md names no scripts, command-line tools or credentials: Instagram SEO is instructions for the agent only.

Does Instagram SEO 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 SEO 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 SEO use?

Instagram SEO 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 SEO use?

About 2k tokens (SKILL.md is roughly 8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 3.4k tokens, read only when the agent opens those files.

What are the alternatives to Instagram SEO?

Skills that share tags, products or a category with Instagram SEO: Google Maps Contact Extract (browser-act/skills, 6.1k stars), Trend Discovery (ScrapeCreators/social-media-research-skills, 3.4k stars), Google Social Media Finder (browser-act/skills, 6.1k stars) and Happycapy Social Publisher (happycapy-ai/Happycapy-skills, 137 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Instagram SEO?

social-media-skills (a GitHub organization) maintains it in social-media-skills/skills, which has 134 GitHub stars. The repository holds 106 skills in this directory. The repository was last updated on October 1, 2026.

Source: social-media-skills/skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.