Agent skill

Hashtag Strategy

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

A skill your agent uses to build a hashtag and discoverability strategy for social posts — the modern (2026) approach, not the outdated "30 hashtags to go viral" playbook.

MITAuto-check passedWriting & Content

Install Hashtag Strategy

skills CLI
$ npx skills add social-media-skills/skills --skill hashtag-strategy -a claude-code

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

GitHub CLI
$ gh skill install social-media-skills/skills hashtag-strategy --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/hashtag-strategy .claude/skills/hashtag-strategy && 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
hashtag-strategy
GitHub stars
134
Token cost
~1.5k tokens
SKILL.md length
626 words
Files
6 (incl. references)
Skills in repo
106
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses to build a hashtag and discoverability strategy for social posts — the modern (2026) approach, not the outdated "30 hashtags to go viral" playbook.

  • Works in 5 steps: Read the foundation + the post → Set the keyword / social-SEO layer (the… → Pick a tight, relevant hashtag set per… → …
  • Build a hashtag and discoverability strategy for social posts — the modern (202
  • SKILL.md covers Step 0 — Read the foundation +…, Step 1 — Set the keyword /…, Step 2 — Pick a tight,… and Step 3 — Add branded /…, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Hashtag Strategy is an agent skill from social-media-skills/skills. Use to build a hashtag and discoverability strategy for social posts — the modern (2026) approach, not the outdated "30 hashtags to go viral" playbook. Run when the user says "hashtags," "what hashtags should I use," "how many hashtags," "hashtag strategy," "help me get discovered/reach," asks "do hashtags still work / are hashtags dead," or asks how to tag a post. Reads brand-profile and audience first. Sets the keyword/social-SEO layer first (caption, on-screen text, spoken audio) because that — plus engagement…

Its SKILL.md is about 1.5k 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/examples.md` and `references/platform-playbook.md`).

It sits in Writing & Content, covering Social media posts. It works with Instagram and TikTok. 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

  • Build a hashtag and discoverability strategy for social posts — the modern (202
  • Not the outdated 30 hashtags to go viral playbook
  • What hashtags should I use
  • How many hashtags

Example prompts

  • “30 hashtags to go viral”
  • “hashtags,”
  • “what hashtags should I use,”
  • “/hashtag-strategy”

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Read the foundation + the post
  2. Set the keyword / social-SEO layer (the real lever)
  3. Pick a tight, relevant hashtag set per platform
  4. Add branded / campaign tags where they apply
  5. Rotate sets; place; publish

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

Hashtag Strategy loads about 1.5k tokens when it runs, and up to ~5k if it reads all its reference files. Until then it costs about 257 tokens; SKILL.md has 626 words of instructions outside code blocks.

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

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). 626 words, ~1,484 tokens.

Download SKILL.mdSave it as .claude/skills/hashtag-strategy/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
hashtag-strategy
description
Use to build a hashtag and discoverability strategy for social posts — the modern (2026) approach, not the outdated "30 hashtags to go viral" playbook. Run when the user says "hashtags," "what hashtags should I use," "how many hashtags," "hashtag strategy," "help me get discovered/reach," asks "do hashtags still work / are hashtags dead," or asks how to tag a post. Reads brand-profile and audience first. Sets the keyword/social-SEO layer first (caption, on-screen text, spoken audio) because that — plus engagement and the content itself — drives discovery far more than hashtags now; then picks a tight, relevant, per-platform hashtag set (respecting caps like Instagram's enforced 5-tag limit), favors niche/mid-tier tags over generic mega-tags, and designs branded/campaign hashtags for community and tracking. Rotates sets rather than copy-pasting one block, and hands placement/publishing to scheduling-and-queue. Sets honest expectations: hashtags categorize and aid search; they are not a reach hack.
metadata.version
1.0.0
license
MIT

Hashtag Strategy

The most valuable thing this skill does is correct an outdated belief. In 2026, hashtags are not a reach hack — platforms understand content directly (captions, on-screen text, audio, visuals, engagement), so tags now mostly categorize a post and aid search. Instagram even removed hashtag-following (2024) and caps hashtags at 5 (2025), and its own head has said more tags don't mean more reach.

So this skill does two jobs, in order:

  1. The keyword / social-SEO layer first — the real discovery lever. Platforms are search engines now; they index your caption, on-screen text, and spoken audio.
  2. A tight, relevant hashtag set on top — per platform, within caps, niche over generic — plus branded/campaign tags where community applies.

(Full reasoning in references/the-2026-reality.md.)

Step 0 — Read the foundation + the post

Load brand-profile.md and audience.md, and look at the actual content/caption being tagged. Tags must match real content and the audience's real searches.

Step 1 — Set the keyword / social-SEO layer (the real lever)

Pick the primary keyword (how the audience actually searches) + a couple of variations, and place them where platforms index:

  • Caption, front-loaded (the first ~80 chars carry most weight).
  • On-screen text (Reels/TikTok/Shorts).
  • Spoken audio (video) — say the keyword aloud; on TikTok the "triple mention" (say + show + caption) is the core ranking move.

This does more for discovery than any tag. Don't skip it to jump to hashtags.

Step 2 — Pick a tight, relevant hashtag set per platform

Per references/platform-playbook.md: Instagram 3–5 (hard cap 5), TikTok 3–5 as keywords, LinkedIn 3–5 specific, X 0–2, Threads 1, Pinterest/YouTube keywords-led. Favor mid-tier/niche tags (~10K–500K posts) over mega-tags; mix topic + niche/community + (sometimes) location/branded. Vet each tag on its page before using (see references/research-and-types.md).

Step 3 — Add branded / campaign tags where they apply

For community/UGC/tracking, design a branded tag (ongoing) or campaign tag (time-bound): short, unique, unused, typo-safe, on-brand, and promoted in bio/caption/CTA. This is the one place hashtags still pull real weight.

Step 4 — Rotate sets; place; publish

  • Build 2–4 reusable sets per pillar and rotate by what each post is about — don't paste one identical block.
  • Placement: caption (best for search/SEO on most platforms).
  • Publish: hand the post + tags to scheduling-and-queue. Respect the IG 5-cap so a post isn't blocked/trimmed.
Show full SKILL.md (259 more words)Show less

Quality bar — self-check

  • Did I lead with the keyword/SEO layer, not hashtags?
  • Is the tag set tight, relevant, niche/mid-tier, and within the platform's cap?
  • Is it per-platform, not one block everywhere?
  • Did I avoid generic mega-tags / #fyp / 30-tag dumps?
  • Did I add a branded/campaign tag where community/UGC applies?
  • Are sets rotated, and is the expectation set honestly (categorize + search, not reach)?
  • No analytics claims WoopSocial can't back?

Edge cases & pushback

  • "Give me 30 to go viral" → push back: more tags ≠ more reach; IG caps at 5; redirect to keywords + content + engagement. Deliver a tight set.
  • "Add #fyp #viral #explore" → decline generic mega-tags; explain #fyp doesn't affect the FYP; offer niche/mid-tier.
  • "Same block on every post" → rotate relevant sets; note copy-paste is low-effort (and frame the shadowban claim accurately — unconfirmed, but relevance/rotation still wins).
  • "Which hashtags perform best for us?" → no WoopSocial analytics; point to native reach-from-hashtags insights or qualitative review.
  • Wrong platform → don't tag X like Instagram; match the playbook.
  • Regulated/sensitive → avoid tags implying unverifiable claims; carry brand guardrails.
  • brand-profile, audience-research — relevance + how the audience searches.
  • caption-writer, tiktok-script, reels-script, carousel-writer, linkedin-post-writer — where the keyword/SEO layer and tags actually live.
  • social-seo, ai-search-optimization — the deeper search/discoverability skills.
  • trend-jacking — riding a live tag/sound moment (vs. evergreen tags here).
  • scheduling-and-queue — publish with the tags in the caption.

References

  • references/the-2026-reality.md — why hashtags ≠ reach now; what they do; the real levers; myths.
  • references/platform-playbook.md — per-platform counts, caps, and the real lever for each.
  • references/research-and-types.md — the 8 tag types, vetting, rotating sets, branded/campaign design.
  • references/examples.md — worked keyword+tag sets per platform, vs the old 30-tag block.

© 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/hashtag-strategy of social-media-skills/skills.

  • SKILL.md
  • evals/evals.json
  • references/examples.md
  • references/platform-playbook.md
  • references/research-and-types.md
  • references/the-2026-reality.md

Open the folder on GitHubat commit 6e30eeb

Compare with similar skills

Hashtag Strategy 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.

Hashtag Strategy compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Hashtag Strategy this skillsocial-media-skills/skills134—~1.5kAutomated safety check: PassMIT
Socialcoreyhaines31/marketingskills54k4 repos~4.5kAutomated safety check: PassMIT
Social Contentfreekmurze/dotfiles1k23 repos~2.1kAutomated safety check: PassNone
Social Captionsrediumvex/social-media-caption-generator-claude131—~2.7kAutomated safety check: NotesMIT
Kortix Socialkortix-ai/suna20k—~1.8kAutomated safety check: PassCustom licence
Content Calendarstevenflanagan1/social-ai-team244—~3.1kAutomated safety check: PassNone

Similar skills

  • Social

    coreyhaines31/marketingskills

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, or Facebook, or wants to do social listening and engagement triage.

    54k GitHub starsUsed in 4 repos~4.5k tokens
    Writing & ContentAuto-check passed
  • Social Content

    freekmurze/dotfiles

    When the user wants help creating, scheduling, or optimizing social media content for LinkedIn, Twitter/X, Instagram, TikTok, Facebook, or other platforms.

    1k GitHub starsUsed in 23 repos~2.1k tokens
    Writing & ContentAuto-check passed
  • Social Captions

    rediumvex/social-media-caption-generator-claude

    Write algorithm-optimized captions/descriptions for social media posts and reels.

    131 GitHub stars~2.7k tokensUpdated 2 mo ago
    Writing & ContentAuto-check: notes
  • Kortix Social

    kortix-ai/suna

    Recipe: write platform-native social content for Kortix (LinkedIn posts, X threads, carousels, Instagram, TikTok, Reels and Shorts video scripts, content calendars) and repurpose one long-form piece…

    20k GitHub stars~1.8k tokensUpdated today
    Writing & ContentAuto-check passed
  • Content Calendar

    stevenflanagan1/social-ai-team

    Builds a month of social media post ideas for SMBs. An agent skill from stevenflanagan1/social-ai-team.

    244 GitHub stars~3.1k tokensUpdated 4 days ago
    Writing & ContentAuto-check passed
  • Outlier Post Finder

    ScrapeCreators/social-media-research-skills

    A skill your agent uses when the user wants to find posts, videos, reels, shorts, tweets, or social content that overperformed versus a creator, brand, or competitor baseline.

    3.4k GitHub stars~1.5k tokensUpdated 1 mo ago
    Writing & ContentAuto-check: notes

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

Works with

Questions about Hashtag Strategy

What does Hashtag Strategy do?

A skill your agent uses to build a hashtag and discoverability strategy for social posts — the modern (2026) approach, not the outdated "30 hashtags to go viral" playbook. Hashtag Strategy is an agent skill from social-media-skills/skills. Use to build a hashtag and discoverability strategy for social posts — the modern (2026) approach, not the outdated "30 hashtags to go viral" playbook.

When should I use Hashtag Strategy?

Hashtag Strategy fits situations like: build a hashtag and discoverability strategy for social posts — the modern (202; not the outdated 30 hashtags to go viral playbook; what hashtags should I use; how many hashtags.

How do I install Hashtag Strategy in Claude Code?

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

How do I install Hashtag Strategy in Codex?

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

Can I use Hashtag Strategy 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 hashtag-strategy -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/hashtag-strategy, .gemini/skills/hashtag-strategy, .github/skills/hashtag-strategy and .opencode/skills/hashtag-strategy in your project.

What does Hashtag Strategy need to run?

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

Does Hashtag Strategy 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 Hashtag Strategy 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 Hashtag Strategy use?

Hashtag Strategy is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Hashtag Strategy use?

About 1.5k tokens (SKILL.md is roughly 5.9k 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.5k tokens, read only when the agent opens those files.

What are the alternatives to Hashtag Strategy?

Skills that share tags, products or a category with Hashtag Strategy: Social (coreyhaines31/marketingskills, 54k stars), Social Content (freekmurze/dotfiles, 1k stars), Social Captions (rediumvex/social-media-caption-generator-claude, 131 stars) and Kortix Social (kortix-ai/suna, 20k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Hashtag Strategy?

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.