К основному содержанию
скилл CX Codex

audience-research · social-media-skills — скилл для Claude Code: исследование аудитории

Скилл разбирает, для кого бренд делает контент: сегменты, задачи, боли, возражения и реальные формулировки аудитории. Пишет audience.md, который читают остальные контент-скиллы.

Установить в Claude Code · Через Skills CLI (Vercel) Все способы и платформы ↓
npx skills add social-media-skills/skills --skill audience-research -a claude-code
Открыть на GitHub

Что делает audience-research

Скилл идёт дальше наброска аудитории из brand-profile. Он собирает доказательства из отзывов, комментариев, форумов, тикетов поддержки и поисковых запросов, а не придумывает портрет по демографии. Демография попадает в результат только если она правда меняет контент, например регион для локального бизнеса.

Работа идёт по шагам: сначала читается brand-profile.md, потом выбираются 1–3 сегмента, для каждого разделяются покупатель и подписчик, если это разные люди. Дальше фиксируются jobs-to-be-done, боли, желания, возражения, уровень подготовки и площадки. Отдельный шаг — языковой банк: фразы аудитории о проблеме и результате в их собственных словах. Итог — audience.md по шаблону references/audience-template.md.

Где доказательств мало, скилл помечает выводы как гипотезы для проверки, а не выдаёт догадки за факты. Если нет brand-profile.md, сначала придётся прогнать brand-profile. Готовый audience.md тоже останавливает работу: скилл загрузит его и предложит пересмотреть только по вашему запросу.

Какие задачи решает

  • понять, кто на самом деле читает контент бренда
  • собрать формулировки клиентов из отзывов и комментариев
  • разделить покупателя и подписчика в B2B
  • найти возражения, из-за которых люди не покупают
  • подготовить основу для контент-плана и рубрикатора

Примеры запросов агенту

  • Кто моя аудитория? Разбери по сегментам и болям.
  • Собери языковой банк из отзывов и комментариев конкурентов.
  • Сделай audience.md перед content-pillars.

Как установить audience-research

1Через Skills CLI (Vercel)

npx skills add social-media-skills/skills --skill audience-research -a claude-code

2Вручную: положить файлы

~/.claude/skills/audience-research/SKILL.md

Папка скилла целиком; для одного проекта — .claude/skills/audience-research/

По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов

Вопросы о audience-research

Как установить audience-research в Claude?

Выполните npx skills add social-media-skills/skills --skill audience-research -a claude-code. Скилл окажется в ~/.claude/skills/audience-research/SKILL.md.

Что делает audience-research?

Собирает сегменты аудитории, их задачи, боли, возражения и реальные формулировки, а затем пишет audience.md. Этот файл читают content-pillars, batch-content-plan и остальные контент-скиллы.

Что нужно, чтобы скилл заработал?

Сначала нужен brand-profile.md с позиционированием и наброском аудитории. Если его нет, скилл попросит прогнать brand-profile первым.

Исходный текст

SKILL.md · MIT
---
name: audience-research
description: >-
  Use to develop a deep, usable understanding of who a brand creates content for — sharp enough
  that every content skill resonates with them specifically. Run when the user says "who's my
  audience," "audience research," "target audience," "build a persona," "customer profile,"
  "ideal customer profile" / "ICP," "who am I talking to," "understand my followers," or
  before content work that needs more audience depth than the
  brand-profile sketch. Reads brand-profile first and goes deeper: jobs-to-be-done, pains,
  objections, and the audience's ACTUAL language (voice-of-customer), grounded in real sources
  where possible — never demographic theater. Produces an audience.md that content-pillars,
  batch-content-plan, and the content skills read. Works for any business.
metadata:
  version: 1.0.0
license: MIT
---

# Audience Research

Knowing the audience deeply is the highest-leverage input to good content. You can have perfect
voice and clean mechanics and still get ignored if the content doesn't speak to what the
audience actually wants, in words they actually use. This skill builds that understanding — and
writes it down so every other skill can use it.

It goes deeper than the audience sketch in `brand-profile`. Two ideas drive it:

1. **Jobs-to-be-done beat demographics.** "35-year-old marketing manager, urban, likes coffee"
   tells you nothing about what to post. "Wants to stop feeling stupid in budget meetings" tells
   you everything. Capture what the audience is *trying to do*, not what census box they tick.
2. **Mirror their language, not your jargon.** The single biggest lever in copy is using the
   audience's own words for their problem. So this skill collects the **voice of the customer** —
   real phrases from real sources — and builds a language bank the content skills draw from.

## When to use this

- After `brand-profile`, when content needs to land harder and the audience sketch isn't enough.
- Before `content-pillars` or a big `batch-content-plan` (audience pains feed both).
- When the user isn't sure who they're really talking to, or content keeps missing.

**When NOT to use it:** if a current `audience.md` exists, load it, summarize it, and move on
unless the user wants to revisit.

## Step 0 — Read the foundation first

Load `brand-profile.md`. It has the positioning, the audience sketch, and the POV. This skill
expands that sketch into something operational. If there's no brand profile, run it first.

## Step 1 — Gather evidence (don't invent)

The difference between research and guessing is **evidence**. Mine the audience's real words and
problems from whatever sources are available (see `references/voice-of-customer.md`):

- The brand's and competitors' **reviews**; **social comments** and replies.
- **Reddit / forums / communities** where the audience actually talks (to act on subreddit findings → `reddit-marketing`).
- **Support tickets, FAQs, sales-call notes, DMs** — the friction and objections, verbatim.
- **Search queries / "people also ask"** — how they phrase what they want.

Use what the user provides; if the agent can access public sources, mine those too. Where
evidence is thin, **flag the gap and mark assumptions as hypotheses to validate** — never
fabricate audience language or pains.

## Step 2 — Define sharp segments (1–3), and buyer vs follower

Pick the **1–3 segments** that matter most — not "everyone." For each, separate two roles when
they differ (especially in B2B):

- **Buyer** — who decides/pays.
- **Follower** — who actually follows, shares, and champions on social.

They're often different people with different needs; content usually leads with the follower.
See `references/jobs-to-be-done.md`.

## Step 3 — Capture the content-relevant dimensions

For each segment, capture only what changes how you'd create content:

- **Jobs-to-be-done** — functional, emotional, and social jobs.
- **Pains** (what blocks the job) and **desires** (the outcome they want).
- **What they already believe** — so content can meet or challenge it.
- **Objections** — why they hesitate; great content answers these pre-emptively.
- **Where they are** — platforms + mindset on each.
- **Who/what they follow** and **what content they engage with**.
- **Sophistication level** — beginner vs expert (changes vocabulary and depth).

Demographics only if they genuinely change the content (e.g., region for a local business).

## Step 4 — Build the language bank

From the evidence, collect the audience's **actual phrases** — how they describe the problem, the
desired outcome, and their objections — in *their* words, not paraphrased into marketing-speak.
This bank is what makes copy feel like it gets them. See `references/voice-of-customer.md`.

## Step 5 — Write the artifact

Produce `audience.md` using `references/audience-template.md`. Flag the primary segment and the
core **transformation** (before → after). Summarize back and invite edits. Content skills read
this on every task.

## Quality bar — self-check

- Is it built on **jobs-to-be-done and real language**, not demographic theater?
- Is the language bank made of the audience's **actual words**, grounded in sources (or honestly
  flagged as assumption)?
- Are there **1–3 sharp segments**, each usable — not "everyone"?
- Is **buyer vs follower** separated where they differ?
- Does every captured dimension actually **change how you'd write**?
- Could a writer who's never met this audience picture a real person and write to them?

If a field wouldn't change a single post, cut it. If you couldn't source a claim, flag it.

## Edge cases

- **No data / no access** → research what public sources you can; otherwise build a structured
  hypothesis from the brand profile and **clearly label it** as to-be-validated. Don't present
  guesses as findings.
- **B2B buyer ≠ user/follower** → capture both; note which content targets which.
- **Multiple distinct audiences** (e.g., nonprofit: beneficiaries + donors) → separate segments
  with different jobs and language.
- **Niche / technical audience** → sophistication and insider language matter most; get the
  jargon right (or right to avoid).
- **"Everyone is my audience"** → push for the one segment that moves the business most now;
  build for them first.
- **Aspirational audience** (who they *want* vs who they *have*) → note both; don't write to a
  fantasy audience that isn't there yet without saying so.

## Related skills

- `brand-profile` — read first; supplies the audience sketch and positioning.
- `content-pillars` — audience pains/jobs become content pillars.
- `batch-content-plan`, the content skills — use segments, pains, and the language bank.
- `voice-builder` — the brand's voice (distinct from the audience's language captured here).

## References

- `references/jobs-to-be-done.md` — the JTBD lens, pains/desires/objections, why it beats personas.
- `references/voice-of-customer.md` — mining real sources for the audience's language (the core).
- `references/audience-template.md` — the audience.md output schema.
- `references/examples.md` — audience profiles across business types vs the useless generic persona.

© social-media-skills · MIT · social-media-skills/skills

Похожие скиллы

Всё по теме «Маркетинг и контент» →

Сначала — audience-research от других авторов.

audience-research ScrapeCreators Оценивает аудиторию блогеров и брендов по открытым метрикам соцсетей, языку и демографии TikTok. Помогает проверить совпадение с целевым рынком перед интеграцией. CX Codex +1 1 200установок audience-mapper aaron-he-zhu Скилл строит портреты аудитории и разбирает нишевые субкультуры перед запуском инфлюенс-кампаний. CX Codex +1 1 000установок extracting-youtube-comments-for-research apidojo Тянет комментарии с YouTube-видео и каналов через Apify и раскладывает их по темам, вопросам и тональности. Нужен, когда надо понять, о чём пишут зрители. CX Codex +1 794установок social-evidence-research Seth Hobson Собирает проверяемый отчёт о обсуждении продукта или темы в соцплатформах. Пригодится для поиска, сравнения и аудита социальных данных. CX Codex 201установок lookalike-audience-seeds Maya-Beth Finotti Помогает выбрать и проверить список клиентов, из которого строится lookalike-аудитория, и понять, хватит ли совпадений под порог платформы. CX Codex +1 20 500установок audience-growth-tracker-sms blacktwist Скилл анализирует динамику подписчиков, выявляет причины всплесков и спадов аудитории и связывает публикации с ростом блога. CX Codex +1 1 600установок blog-persona AgriciDaniel Скилл собирает профиль авторского голоса по четырём шкалам тона и сохраняет его в JSON, чтобы blog-write и blog-rewrite держали один стиль. CX Codex +1 2 500установок

Из того же набора67

content-calendar Собирает повторяющийся контент-календарь: какие рубрики и форматы выходят в какие дни. Пригодится, когда посты нужно планировать циклами, а не разово. CX Codex +1 786установок content-pillars Скилл выводит 3–5 повторяющихся тем бренда из его позиционирования и аудитории. Нужен перед планированием контента, когда непонятно, о чём вообще постить. CX Codex +1 768установок tiktok-script Пишет нативный сценарий TikTok под алгоритм For You Page: хук на первую секунду, удержание, повторные просмотры и поисковые ключевые слова. CX Codex +1 768установок carousel-writer Скилл пишет многослайдовые карусели для Instagram, LinkedIn и TikTok: обложка с хуком, по одной мысли на слайд и CTA на сохранение. CX Codex +1 755установок storytelling-and-narrative Скилл раскладывает любой пост на арку: завязка, перелом, развязка. Пригодится, когда текст плоский и не цепляет. CX Codex +1 724установок captions-and-clipping Превращает длинное видео в вертикальные клипы с субтитрами для просмотра без звука. Помогает, когда из подкаста или вебинара нужно сделать Shorts, Reels и TikTok. CX Codex +1 720установок thumbnail-design Скилл пишет бриф на обложку YouTube и план A/B-теста: одна точка фокуса, читаемость на телефоне, честное обещание вместо кликбейта. CX Codex +1 699установок cross-platform-repurposing Разбирает один материал на смысловые атомы и пересобирает их под каждую площадку: свой хук, формат, длина, CTA. Пригодится, когда из одного текста нужна неделя постов. CX Codex +1 695установок

Спонсоры проекта

Компании, которые помогают держать аналитику открытой