Skip to main content
skill CX Codex

social-seo — Claude Code skill: make social posts findable in search

A skill that turns social posts into search assets: keyword research, per-platform indexed fields, evergreen clusters.

Install into Claude Code · Skills CLI (Vercel) All methods and platforms ↓
npx skills add social-media-skills/skills --skill social-seo -a claude-code
Open on GitHub

What social-seo does

social-seo treats search on social platforms as its own layer. People search TikTok, Instagram, YouTube, Pinterest and LinkedIn for different intents, and feed-only optimization leaves you invisible to anyone actively looking. The lever is keywords, not hashtags — hashtags are a minor category signal.

The skill runs six steps. It loads brand-profile.md and audience.md first, so the audience's own search language drives everything. Then keyword research via platform autocomplete, related searches, comments and native search analytics. Next comes placement across indexed surfaces: TikTok gets spoken audio, on-screen text and caption (the triple mention), Instagram gets caption, the searchable name field, bio and alt text, YouTube gets a keyword-led title, description and transcript. After that: topical clusters and the profile as a search asset.

The agent cannot pull live search volumes, and the skill forbids inventing numbers — you get the method and work from intent and specificity instead. Hashtag specifics route to hashtag-strategy; the AI-search citation layer goes to ai-search-optimization. Measurement stays on native platform search insights, not WoopSocial. Ask for exact volumes or 30 hashtags and it pushes back: stuffing dilutes the topical signal.

What it helps with

  • find the queries people actually type into TikTok and YouTube
  • place keywords across each platform's indexed fields
  • build an evergreen cluster around one pillar topic
  • rewrite the name field and bio so the profile gets found
  • track which search terms bring people to your posts

Example prompts for the agent

  • run social-seo for my TikTok account, I want to show up in search
  • find keywords for YouTube and map them to title, description and captions
  • build an evergreen cluster around home workouts

How to install social-seo

1Skills CLI (Vercel)

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

2Manually: put the files in place

~/.claude/skills/social-seo/SKILL.md

Copy the whole skill folder; for one project use .claude/skills/social-seo/

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

Questions about social-seo

How do I install social-seo in Claude?

Run npx skills add social-media-skills/skills --skill social-seo -a claude-code. The skill file lands at ~/.claude/skills/social-seo/SKILL.md.

What does social-seo do?

It researches queries through autocomplete and native analytics, places keywords on each platform's indexed surfaces, and builds topical clusters. The profile gets optimized as a search asset along the way.

Can it give me exact search volumes?

No. It does not pull live volumes and will not fabricate numbers — it hands you the research method and works from intent and specificity.

Source text

SKILL.md · MIT
---
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.

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

## Related skills

- `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 · social-media-skills/skills

Similar skills

Everything for SEO and GEO →

From the same set67

linkedin-post-writer Writes LinkedIn posts around the platform's mechanics: a first line that earns the expand, formatting built for dwell time, links pushed to the first comment. Useful for founder and thought-leadership content. CX Codex +1 628installs experimentation-and-ab-testing Designs disciplined organic A/B tests for social content: one variable, a decision rule set before publishing, repetitions. Settles content debates with evidence. CX Codex +1 626installs social-selling-and-dm Designs a comment-to-DM-to-email funnel and drafts the messages. Built for people who opted in, never for cold outreach. CX Codex +1 625installs community-management Turns an audience into a community where members talk to each other. Useful when you want to start a group or channel instead of chasing followers. CX Codex +1 636installs behind-the-scenes-and-founder A skill for transparency content: build-in-public updates, founder story, honest posts about mistakes, all from the founder's own voice. CX Codex +1 622installs content-recycling A skill that brings proven evergreen posts back on a schedule with a new hook and updated facts, not a copy-paste repost. Useful when your best material sits idle. CX Codex +1 619installs veo-3 Writes prompts for Google Veo 3.1 video generation: social clips, still-image animation, vertical videos with native synchronized audio. CX Codex +1 630installs link-in-bio-and-traffic A skill that turns social reach into clicks and an owned audience: one clear action, capture before the sale, correct link placement. CX Codex +1 630installs

Project sponsors

Companies that keep this analytics open
Gold sponsor

Impressions, clicks and code copies — open statistics. We keep the numbers public for the same reason NeBlask itself is public. Become a sponsor