Skip to content
Marketing
Skill

/instagram-seo

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

From plugin
social-media-skills
86106 skills
Install
$ npx -y skills add social-media-skills/skills --skill instagram-seo --agent claude-code

How it fires

How this skill gets triggered: by you, by Claude, or both.

  • Fires itselfAuto-invocation. Claude auto-loads it when your prompt matches the work.Auto-invocation is when the right skill fires by itself at the right moment, driven by a FLOW.md router and a hook, instead of you invoking it by name. It is the difference between a skill being installed and a skill actually getting used.Read the full definition →
  • You can call itInvoke it directly when you want it.
  • Slash command/instagram-seo

Context preview

The summary Claude sees to decide when to auto-load this skill.

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

SKILL.md

instagram-seo.SKILL.md
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`.

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,

Read more
Ships withsocial-media-skills

Give your AI agent the skills of a top-1% social media team. 106 of them, free.

Get the whole plugin
Stats
88
Stars
16
Forks
Active
Maintenance
Shell
Language
MIT
License
13d ago
Last commit
2mo ago
Created

Repo: social-media-skills/skills

Other skills on social-media-skills.