A skill your agent uses to make social content discoverable through SEARCH across social platforms — the social-SEO / keyword-discovery skill.

MITAuto-check passedMarketing & SEO

Install Social SEO

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

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

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

At a glance

A skill your agent uses to make social content discoverable through SEARCH across social platforms — the social-SEO / keyword-discovery skill.

  • Works in 7 steps: Read the foundation + the goal → Keyword research (real demand, never… → Place keywords across the platform's SEO… → …
  • Make social content discoverable through SEARCH across social platforms — the social-SEO / keyword-discovery skill
  • SKILL.md covers Step 0 — Read the foundation +…, Step 1 — Keyword research…, Step 2 — Place keywords across… and Step 3 — The on-content…, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Social SEO is an agent skill from social-media-skills/skills. Use to make social content discoverable through SEARCH across social platforms — the social-SEO / keyword-discovery skill. Run when the user says "social SEO," "get found in search," "TikTok SEO," "YouTube SEO," "keywords for social," "searchable captions," or wants search across platforms rather than just the feed. For single-platform depth, route "Instagram SEO" to instagram-seo and Pinterest asks to pinterest-seo; this skill owns the cross-platform framework. Reads brand-profile and audience first. All…

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/examples.md` and `references/keyword-research-and-technique.md`).

It sits in Marketing & SEO, covering AI search optimization, Keyword research and Social media posts. It works with Pinterest, TikTok, Instagram and YouTube. 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

  • Make social content discoverable through SEARCH across social platforms — the social-SEO / keyword-discovery skill
  • Says social SEO
  • Get found in search
  • Keywords for social

Example prompts

  • “social SEO,”
  • “get found in search,”
  • “TikTok SEO,”
  • “/social-seo”

Workflow steps

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

  1. Read the foundation + the goal
  2. Keyword research (real demand, never invented)
  3. Place keywords across the platform's SEO surface
  4. The on-content technique
  5. Build topical clusters (evergreen authority)
  6. Optimize the profile as a search asset
  7. Measure (honestly) + hand off GEO

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

Social SEO loads about 2k tokens when it runs, and up to ~6.3k if it reads all its reference files. Until then it costs about 241 tokens; SKILL.md has 808 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~241
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
~6.3k

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). 808 words, ~2,005 tokens.

Download SKILL.mdSave it as .claude/skills/social-seo/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
social-seo
description
Use to make social content discoverable through SEARCH across social platforms — the social-SEO / keyword-discovery skill. Run when the user says "social SEO," "get found in search," "TikTok SEO," "YouTube SEO," "keywords for social," "searchable captions," or wants search across platforms rather than just the feed. For single-platform depth, route "Instagram SEO" to instagram-seo and Pinterest asks to pinterest-seo; this skill owns the cross-platform framework. Reads brand-profile and audience first. All platforms are search engines; keywords, not hashtags, are the lever. Covers per-platform indexed surfaces, keyword research via autocomplete + native analytics (never fabricates volumes), the triple-mention technique, topical clusters, and the profile as a search asset. Routes hashtags to hashtag-strategy; hands the AI-search/LLM-citation (GEO) layer to ai-search-optimization. Measures via native search insights, not WoopSocial analytics.
metadata.version
1.0.0
license
MIT

Social SEO

Make content findable when people search, not just visible when the feed happens to show it. In 2026 every social platform is a search engine, and search is the highest-intent, most evergreen discovery there is.

Four truths shape everything:

  1. All social platforms are search engines (TikTok/IG/YouTube/Pinterest/LinkedIn) — and people search different platforms for different intents. If you only optimize for the feed, you're invisible to people actively looking.
  2. Keywords, not hashtags, are the lever. Write for the search bar first; hashtags are a minor category signal → hashtag-strategy.
  3. Search optimization doubles as recommendation optimization — the keywords that get you found in search are the same signals the algorithm uses to categorize you for the right feed/FYP audience.
  4. SEO turns posts into evergreen assets — a search-optimized post keeps getting found for months; a feed post dies in ~48h.

(Full model + the AI-search/GEO boundary: references/why-social-search.md.)

Step 0 — Read the foundation + the goal

Load brand-profile.md and audience.md (their exact search language matters). Get the platform(s) and what the user wants to be found for.

Step 1 — Keyword research (real demand, never invented)

Find the terms people actually search via platform autocomplete, "others searched for", related searches, comments, audience language, and the user's native search analytics (+ tools like TikTok Creative Center / VidIQ). The agent can't pull live search volumes — never fabricate numbers; give the method and work from intent/specificity. Favor long-tail, intent-rich queries you can genuinely answer. See references/keyword-research-and-technique.md.

Step 2 — Place keywords across the platform's SEO surface

Each platform indexes different things — optimize the right ones (full per-platform guide in references/platform-seo-surfaces.md):

  • TikTok — spoken audio (transcribed) + on-screen text + caption (the triple mention).
  • Instagram — caption + the searchable name/display field + bio + alt text + captioned Reels.
  • YouTube — keyword-led title + ~200–300w description + transcript/captions + chapters.
  • Pinterest — keyword title + description + board names + alt (hashtags deprecated there).
  • LinkedIn — searchable headline/About + on-topic post keywords → linkedin-growth.
  • Cross-cutting — subtitles, alt text, descriptive file names, a consistent branded handle.

Step 3 — The on-content technique

Lead with keywords, support with hashtags. State the primary phrase in natural language, early, once or twice; align audio + on-screen + caption to one search intent; add 3–5 niche hashtags. Never keyword-stuff (spam dilutes your topical signal). Resolve the search-vs-feed tension (clarity vs hook) deliberately. See references/keyword-research-and-technique.md.

Step 4 — Build topical clusters (evergreen authority)

One post rarely owns a query. Cluster evergreen content around a pillar topic so you become the answer/authority — which compounds and sharpens recommendation categorization. Map a content-pillars pillar → a keyword cluster → many evergreen posts.

Step 5 — Optimize the profile as a search asset

The name/display field, handle, headline/bio should carry the searchable keyword/category (not just a clever brand line). This is the searchability lens — profile-optimization owns the conversion lens; both matter. Public profiles/content are increasingly Google-indexable too.

Step 6 — Measure (honestly) + hand off GEO

Track discoverability: impressions from search, the search terms that found you, profile visits from non-followers, saves, evergreen-post growth — via native platform search analytics (+ Search Console/UTMs). No WoopSocial analytics. For getting cited by AI search/LLMs (GEO), hand off to ai-search-optimization — related but separate.

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

Orchestration map

social-seo sets the discovery layer; it routes to / is routed from: hashtag-strategy (hashtag specifics) · caption-writer (adds the keyword layer) · profile-optimization (conversion lens) · content-pillars (clusters) · tiktok-growth / instagram-growth / linkedin-growth (search as a growth pillar) · ai-search-optimization (GEO hand-off) · scheduling-and-queue (publish).

Quality bar — self-check

  • Did I do real keyword research (autocomplete/native analytics) and avoid inventing volumes?
  • Did I optimize the platform-specific indexed surfaces (not one generic answer)?
  • Did I use lead-with-keywords + the triple mention, in natural language (no stuffing)?
  • Did I think in evergreen clusters / topical authority, and note the search = recommendation payoff?
  • Did I treat the profile as a search asset, route hashtags to hashtag-strategy, and hand GEO to ai-search-optimization?
  • Native-search-insights measurement, no WoopSocial analytics, searchability not guaranteed rankings?

Edge cases & pushback

  • "Give me exact search volumes" → can't pull live volume; show the research method; don't fabricate.
  • "Stuff every keyword + 30 hashtags" → refuse; spam dilutes the signal; natural language + a few niche tags.
  • "I optimized one post, done" → build a cluster; one post rarely owns a query.
  • "Just use trending hashtags" → hashtags categorize, keywords get found → hashtag-strategy.
  • "Make ChatGPT/Google-AI cite me" → that's GEO → ai-search-optimization.
  • "Which post ranks best?" → native platform search insights; no WoopSocial analytics.
  • Clever-but-vague title → keep the searchable phrase; add intrigue after the keyword.
  • brand-profile, audience-research — the search language and positioning.
  • instagram-seo, pinterest-seo — single-platform search depth (route platform-specific asks there).
  • hashtag-strategy — the hashtag layer (a minor signal); caption-writer — caption craft.
  • profile-optimization — profile as conversion (this skill = profile as search).
  • content-pillars — pillars become keyword clusters; the growth skills lean on search.
  • ai-search-optimization — the AI-search/LLM-citation (GEO) hand-off; scheduling-and-queue — publish.

References

  • references/why-social-search.md — the 2026 reality, the three layers, search=recommendation, evergreen, the GEO boundary.
  • references/platform-seo-surfaces.md — what each platform indexes and how to optimize it (TikTok/IG/YouTube/Pinterest/LinkedIn/X/FB + cross-cutting).
  • references/keyword-research-and-technique.md — finding keywords (no fabrication), the triple-mention technique, clusters, no-stuffing, measurement.
  • references/examples.md — worked optimizations per platform + a cluster plan + honest scope.

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

  • SKILL.md
  • evals/evals.json
  • references/examples.md
  • references/keyword-research-and-technique.md
  • references/platform-seo-surfaces.md
  • references/why-social-search.md

Open the folder on GitHubat commit 6e30eeb

Compare with similar skills

Social 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.

Social SEO compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Social SEO this skillsocial-media-skills/skills134—~2kAutomated safety check: PassMIT
Bulkpublish Social Schedulingdavepoon/buildwithclaude3.6k—~1.3kAutomated safety check: PassMIT
Social Media Managementmanojbajaj95/claude-gtm-plugin1051 repos~3.9kAutomated safety check: PassMIT
Comment MiningScrapeCreators/social-media-research-skills3.4k—~1kAutomated safety check: NotesMIT
Trend DiscoveryScrapeCreators/social-media-research-skills3.4k—~789Automated safety check: NotesMIT
Google Social Media Finderbrowser-act/skills6.1k—~1.7kAutomated safety check: PassMIT

Similar skills

  • 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
  • Social Media Management

    manojbajaj95/claude-gtm-plugin

    Comprehensive social media management for all platforms (LinkedIn, Twitter/X, Instagram, TikTok, Facebook, Pinterest, YouTube).

    105 GitHub starsUsed in 1 repo~3.9k tokens
    Writing & ContentAuto-check passed
  • Comment Mining

    ScrapeCreators/social-media-research-skills

    A skill your agent uses when the user wants to mine comments and replies for audience reactions, customer language, questions, objections, complaints, product ideas, buying intent, sentiment, or…

    3.4k GitHub stars~1k tokensUpdated 1 mo ago
    Marketing & SEOAuto-check: notes
  • 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
  • Caption Writer Sms

    blacktwist/social-media-skills

    When the user wants to write a caption for a visual-first social media post on Facebook, Instagram, TikTok, Pinterest, or YouTube.

    560 GitHub stars~5.3k tokensUpdated 5 mo ago
    Writing & ContentAuto-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 Social SEO

What does Social SEO do?

A skill your agent uses to make social content discoverable through SEARCH across social platforms — the social-SEO / keyword-discovery skill. Social SEO is an agent skill from social-media-skills/skills. Use to make social content discoverable through SEARCH across social platforms — the social-SEO / keyword-discovery skill.

When should I use Social SEO?

Social SEO fits situations like: make social content discoverable through SEARCH across social platforms — the social-SEO / keyword-discovery skill; says social SEO; get found in search; keywords for social.

How do I install Social SEO in Claude Code?

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

How do I install Social SEO in Codex?

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

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

What does Social SEO need to run?

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

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

Social SEO 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 Social 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 4.3k tokens, read only when the agent opens those files.

What are the alternatives to Social SEO?

Skills that share tags, products or a category with Social SEO: Bulkpublish Social Scheduling (davepoon/buildwithclaude, 3.6k stars), Social Media Management (manojbajaj95/claude-gtm-plugin, 105 stars), Comment Mining (ScrapeCreators/social-media-research-skills, 3.4k stars) and Trend Discovery (ScrapeCreators/social-media-research-skills, 3.4k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Social 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.