Skip to main content
skill CX Codex

ig-hashtag-strategist — Claude Code skill for Instagram hashtags

The ig-hashtag-strategist skill for Claude Code and Codex builds a 3–5 hashtag set for a post, carousel, or Reel, balanced across niche, mid, and broad tiers.

MIT ★ 897 updated 2026-10-21

Install into Claude Code · Plugin marketplace All methods and platforms ↓
/plugin marketplace add sergebulaev/instagram-skills
/plugin install instagram-skills@instagram-skills
Open on GitHub

What ig-hashtag-strategist does

The skill starts from the idea that 3–5 matched tags outperform a 30-tag block — a shift that reflects how the platform treats hashtags in 2026: as topic labels, not reach multipliers. Given a post description, the skill extracts 3–5 real topics, generates tier candidates for each, and assembles a set of 2–3 niche + 1–2 mid + 0–1 broad. The broad slot is dropped if nothing genuinely fits.

Engagement-farm tags (#follow4follow, #like4like) are flagged and removed. Off-topic tags get rejected even when they're large — a mismatch trains the recommendation engine against the post. Because Instagram's API doesn't expose live post counts, tier estimates rely on phrase specificity; the skill tells the user to verify the numbers inside the app's search.

Each tag in the output carries a tier label and a one-line reason. The skill covers hashtags only — caption writing belongs to ig-caption-writer. It also tells the user to rotate sets across posts, because identical tag blocks across many uploads register as automation.

What it helps with

  • Pick 3–5 hashtags sized to where a small account can rank
  • Classify tags by niche, mid, and broad tiers for a post
  • Remove engagement-farm and flagged tags from a set
  • Reject popular-but-off-topic tags that confuse the recommendation engine
  • Rotate hashtag sets across posts to avoid automation patterns

Example prompts for the agent

  • Build a hashtag set for this Notion-for-freelancers post, small account
  • Give me niche and mid tags for a productivity carousel
  • Review my current hashtags and replace any spam tags with on-topic ones

How to install ig-hashtag-strategist

1Plugin marketplace

/plugin marketplace add sergebulaev/instagram-skills
/plugin install instagram-skills@instagram-skills

This installs the whole instagram-skills plugin with all its skills

2Skills CLI (Vercel)

npx skills add sergebulaev/instagram-skills --skill ig-hashtag-strategist -a claude-code

3Manually: put the files in place

~/.claude/skills/ig-hashtag-strategist/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/ig-hashtag-strategist/

Step by step, with commands for each platform: How to install skills in Claude Code: five ways

Questions about ig-hashtag-strategist

How do I install ig-hashtag-strategist in Claude Code?

Run /plugin marketplace add sergebulaev/instagram-skills, then /plugin install instagram-skills@instagram-skills. The skill loads from ~/.claude/skills/ig-hashtag-strategist/SKILL.md.

What does ig-hashtag-strategist do?

It builds a 3–5 tag set with each tag assigned to a tier — niche (under 50k posts), mid (50k–500k), or broad (500k+) — along with a one-line rationale and placement guidance.

Can ig-hashtag-strategist write the caption too?

No. This skill handles hashtag selection only. Caption writing is the job of the separate ig-caption-writer skill.

Source text

SKILL.md · MIT
---
name: ig-hashtag-strategist
description: "Build a sized Instagram hashtag set for a post using the 2026 reality that 3 to 5 well-chosen tags beat 30 random ones. Sizes each tag as niche (under 50k posts), mid (50k to 500k), or broad (500k+), then assembles a 2-3 niche, 1-2 mid, 0-1 broad mix that a small or mid account can actually rank in, matched to the post content and rotated to avoid spam patterns. Use to choose hashtags for a caption, carousel, or Reel. Not for writing the caption itself (use ig-caption-writer)."
---

# Instagram Hashtag Strategist

Pick 3-5 hashtags that actually help, sized so the post can rank. The 30-tag wall
is dead: in 2026 hashtags work as topic labels, and a small account ranks in
niche tags, not in million-post broad ones. This skill builds the sized set.

## When to use

- User has a caption, carousel, or Reel and needs hashtags
- User is still posting 20-30 generic tags and wants the 2026 approach
- User wants tags sized to where their account can actually rank

## The model: size, not volume

A tag's **size** is its total post count. The strategy is a mix so the post
ranks in the small tags while touching the bigger ones.

| Tier | Post count | Role | Use |
|---|---|---|---|
| Niche | under 50k | where a small/mid account can actually rank for hours | 2-3 |
| Mid | 50k - 500k | enough audience, beatable competition | 1-2 |
| Broad | 500k+ | a brief category-label touch, ranks for minutes | 0-1 |

**Default: 3-5 total.** Full reasoning in `../../references/hashtag-strategy.md`.

## Steps

1. **Get the post.** The caption, carousel topic, or Reel subject, plus the
   target audience and the account's rough size (so the niche/mid split fits).
2. **Extract topics.** Pull the 3-5 real topics the post is about (the subject,
   the niche community, the format, the outcome).
3. **Generate candidates per tier.** For each topic, propose niche, mid, and
   broad candidates. Niche tags are specific and long-tail
   (`#notionforfreelancers`); broad tags are single common words (`#marketing`).
4. **Size each candidate.** Estimate the tier from specificity (the API does not
   expose counts, so use judgment and tell the user to verify counts in the app's
   search). Flag any obviously generic or flag-prone tags
   (`#follow4follow`, `#like4like`) to drop.
5. **Assemble the set.** 2-3 niche + 1-2 mid + 0-1 broad, total 3-5. Drop the
   broad slot if nothing genuinely fits. Every tag must match the content.
6. **Check the match.** Reject any tag that is popular but off-topic; a mismatch
   mistrains the recommendation engine and lowers reach.
7. **Rotate.** Tell the user to vary the set per topic, not reuse one block on
   every post (identical sets across many posts read as automation).
8. **Output.** The 3-5 set, each tagged with its tier and a one-line why, plus
   placement guidance (end of caption or first comment).

## Output format

```
Sized set (4 tags):
  #notionforfreelancers   niche   the exact community this post serves
  #freelanceworkflow      niche   long-tail, low churn, rankable
  #productivitytips       mid     warm relevant audience, beatable
  #notion                 broad   category label, one touch

Placement: end of the caption or the first comment. Rotate the niche tags per topic.
```

## Hard rules

Global voice rules: see root `SKILL.md` Voice rules. Additional skill-specific
rules:

- 3-5 tags total. Never output a 30-tag block.
- Every tag must describe the actual content. No popular-but-off-topic tags.
- At most one broad tag; drop it if nothing fits.
- Flag and remove engagement-farm tags (`#follow4follow`, `#like4like`) and any
  known flagged tags.
- Hashtags go at the end of the caption or in the first comment, never
  mid-sentence.
- Rotate sets per topic; do not hand the user one block to paste forever.

## Anti-patterns (skill will refuse)

- Outputting 20-30 hashtags.
- A "viral hashtag pack" of generic broad tags.
- Tags that do not match the post to chase a bigger audience.
- Hiding 30 tags behind dots to "look clean".
- All-broad sets a small account cannot rank in.

## Resources

- `../../references/hashtag-strategy.md` - the full 2026 sizing model and recipe
- `../../references/algorithm-heuristics.md` - why sends and saves, not hashtag feeds, drive reach

## Related skills

- `ig-caption-writer` - writes the caption the hashtags attach to
- `ig-carousel-planner` - the carousel whose caption carries the set
- `ig-content-planner` - rotate tag themes across a week

© Serge Bulaev · MIT · sergebulaev/instagram-skills

Similar skills

All skills for Marketing and content →

From the same set11

The whole set →
instagram-marketing instagram-marketing is a skill for drafting Instagram captions, carousel plans, and weekly schedules, and for auditing profiles or audience stats. CX Codex +1 1,500installs ig-hook-extractor ig-hook-extractor is a Claude Code skill that breaks down hooks in Instagram Reels and carousels from a URL or pasted text. It identifies the formula, post goal, and a template for your topic. CX Codex +1 ★ 897repo stars ig-content-planner ig-content-planner turns a theme, an audience, and content pillars into a 7-day Instagram posting calendar with formats, hooks, and goals for each slot. CX Codex +1 ★ 897repo stars ig-audience-insights ig-audience-insights reads Instagram hashtags and competitor profiles using real data from Apify without needing an account login. Finds top-performing post patterns. CX Codex +1 ★ 897repo stars ig-profile-optimizer The ig-profile-optimizer skill reviews nine parts of an Instagram profile and suggests edits based on the account’s goal. Use it to rethink the profile header and opening grid. CX Codex +1 ★ 897repo stars ig-caption-writer ig-caption-writer is a skill that drafts Instagram captions with a hook in the first 125 characters, a skimmable body, and one CTA. CX Codex +1 ★ 897repo stars ig-carousel-planner ig-carousel-planner maps multi-slide Instagram carousels up to 10 slides, writes on-image text, prepares captions, and schedules posts through Publora. CX Codex +1 ★ 897repo stars ig-repurposer ig-repurposer rebuilds LinkedIn posts, blog pieces, YouTube scripts, and X threads for Instagram. It reshapes the hook and format, then sends the approved post through Publora. CX Codex +1 ★ 897repo stars

Project sponsors

Companies that keep this analytics open