Skip to content
OpenAgentSkill
Browsing is open · Catalog captured 2026-11-21 · Automatic updates and account services are paused.
Search & research

audience-research

Mine where your audience actually talks (reviews, Reddit, YouTube comments, communities) and produce two brand files, audience.md (segments, awareness, jobs-to-be-done, watering holes) and voc.md (verbatim pain/desire/objection language with sources). Use it before positioning or copy work, when launching into a new market, or when copy keeps missing because nobody knows how customers actually describe the problem.

boringmarketer · Static checks on file

Installation

Read the source and dependencies before running a command. Copying does not install or execute anything.

npx skills add boringmarketer/boring-marketing-skills --skill audience-research

About this skill


name: audience-research description: Mine where your audience actually talks (reviews, Reddit, YouTube comments, communities) and produce two brand files, audience.md (segments, awareness, jobs-to-be-done, watering holes) and voc.md (verbatim pain/desire/objection language with sources). Use it before positioning or copy work, when launching into a new market, or when copy keeps missing because nobody knows how customers actually describe the problem. when_to_use: research my audience, who is my audience, voice of customer, what do customers say, mine reviews, customer language, refresh my audience research, why isn't my copy landing, audience for X argument-hint: "[product URL or description; optionally 'refresh' to diff against existing research]" metadata: boring: version: 4.1.1 layer: foundation reads: [positioning#market-assessment, brand-manifest] writes: [audience, voc] optional-keys: [FIRECRAWL_API_KEY, EXA_API_KEY, SCRAPECREATORS_API_KEY, TREG_TOKEN] enhances_with: - toolset: social-data gains: "mines documented Reddit and community material with deeper live evidence"

Audience Research

Find the rooms where your buyers complain, compare, and confess, and bring back their exact words. Done means two files: an audience profile where every claim traces to evidence, and a verbatim language bank that lets every downstream skill enter the conversation already happening in the customer's head. The judgment this skill carries: knowing which sources are signal for which business, and refusing to launder paraphrase as voice-of-customer. The method is a floor, not a ceiling. When the category in front of you argues for different sources or sequence, take them and say why.

Context

Only if ./brand/, ./brands/ or MARKETING.md exists (nothing to load otherwise), run: python3 ${CLAUDE_SKILL_DIR}/../start-here/scripts/brand_context.py --for audience-research (If the script or python3 is unavailable, read the files named in reads: directly, section-anchored where specified. If none exist, proceed standalone. Ask only for what the task strictly requires.)

If positioning.md#market-assessment exists, use its declared Category: and the known competitors as mining seeds. If audience.md or voc.md already exist (check brand.yaml), default to Refresh mode unless the user asks to start over.

Modes

  • Full research (default): Phases 1-4 below. Needs a product URL or a one-line description + category.
  • Refresh ("refresh my audience research"): diff new mining against existing files. See Refresh mode.
  • Interview fallback: no URL, web access failing, or the user explicitly wants a fast draft. See Interview fallback. The audience.md header carries Data: MODEL KNOWLEDGE, and the chat note says in plain words that this is a draft from category knowledge, not mined research. Never let it masquerade as mined research.
  • Quick Mode: a narrow ask ("what do customers say about onboarding?", "mine pricing objections") gets a targeted mine of 2-3 sources on that theme only, appended to voc.md under the matching section. No source map ceremony, no full synthesis. Deliver, then one line of what's-next.

Phase 1: Source map

From the product category, pick 5-8 mining sources. This is a judgment call, not a checklist: the wrong sources return polite noise; the right ones return rage, longing, and exact vocabulary.

Highest-signal sources by business type:

Business typeMine firstAlso strongUsually weak
B2B SaaSG2 + Capterra (2-4★), category subreddits, competitor G2 reviewsLinkedIn comment threads, niche Slack/Discord (if public), HN threadsTwitter praise, vendor case studies
E-com / consumer productAmazon reviews (own + competitor, 2-4★), RedditTrustpilot, YouTube review comments, TikTok commentsInstagram comments (performative)
Mobile / appApp Store + Play Store reviews (sort: recent, not helpful), RedditYouTube tutorial commentsThe app's own community (survivor bias)
Services / agencyReddit ("anyone hired a...?" threads), X/LinkedIn discussionsGoogle/Clutch reviews, podcast episode commentsTestimonial pages
Local service businessGoogle reviews (2 to 4 stars) of the business and the top 3 in its map pack, Reddit trade and city threads ("anyone used a good plumber in...?"), Angi, Yelp and BBB complaintsNextdoor and neighborhood groups when public, ThumbtackThe business's own testimonials page
Creator / info productYouTube comments on category videos (not the creator's own), RedditX replies under big accounts in the niche, Udemy/Skool reviews of competing coursesThe creator's own audience (already converted)

Rules that govern the map:

  • Local example (sample business Hartline Plumbing, Dallas TX). Mine its Google reviews and those of the top three plumbers in the map pack, one Dallas thread search ("plumber", "water heater", "overcharged"), and the one-to-three-star Angi or Yelp reviews. The switching triggers are usually showing up late, surprise bills and no callback. Those words become the language for ads and the first screen.
  • Competitor reviews outrank your own. Your reviews tell you about your product; competitor reviews tell you about the market. Competitor 1-star reviews are switching triggers verbatim. Default: at least one miner on a competitor review surface.
  • Find the real subreddits, don't guess. Search site:reddit.com [category problem language] and verify the sub is alive (posts in the last week, comments per post >3) before assigning a miner to it. A dead sub burns a slot. We use Exa for this search: it matches on meaning, so a thread that describes the problem in the customer's own words comes up even when no keyword matches (free tier, then pay as you go). Without it, the site:reddit.com search in WebSearch does the job.
  • **One s
Read the complete source ↗