aiskillstore/marketplace / skills/aaron-he-zhu/audience-mapper
audience-mapper
VerifiedUse when the user asks to "analyze my target audience", "build an audience profile for influencer targeting", "research a niche community", or "deep-dive a subculture before partnering with creators"; in audience mode produces demographic/psychographic profiles, a platform-priority matrix, named personas, and an influencer-selection criteria set, and in niche mode produces a community map, culture decode (language/norms/taboos), key-voice tiers, a Brand Fit Score, and a phased entry strategy. Not for finding specific creators to contract — use influencer-discovery; not for scoring a shortlist on ACE — use fit-scorer. 目标受众画像/人群分析 · 细分社群/亚文化调研
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 13.6 KB |
| references/templates.md | markdown | 20.8 KB |
| skill-report.json | config | 37.5 KB |
references/templates.md
View on GitHub# Audience Mapper — Templates
Fill-in templates for both modes. Mark every inferred attribute with a confidence level (High/Med/Low) so unsupported guesses stay visible. Lead with user-supplied data. Steps map to the numbered Instructions in [../SKILL.md](../SKILL.md): **audience** mode uses §A1–A9, **niche** mode uses §N1–N7.
---
## 1 — Set the Mode & Gather Context
Confirm or infer the mode, state it, then fill the shared block. Niche mode fills the extra rows.
```markdown
### Mapping Parameters
**Mode**: audience | niche (inferred → state why)
**Brand/Product**: [name]
**Category**: [industry/vertical]
**Current Customer Base**: [description if available]
**Geographic Focus**: [regions/countries]
**Price Point**: [budget/mid/premium]
**Campaign Objective**: [awareness/consideration/conversion]
<!-- niche mode adds: -->
**Niche/Community**: [name]
**Parent Category**: [broader category]
**Research Goal**: [awareness/partnership/entry strategy]
**Platforms to Focus**: [platforms]
```
---
# audience mode (§A2–A9)
## A2 — Analyze Demographics
```markdown
## Demographic Profile
### Primary Audience
| Attribute | Profile | Confidence |
|-----------|---------|------------|
| Age Range | [X-Y years] | High/Med/Low |
| Gender | [distribution] | High/Med/Low |
| Location | [primary markets] | High/Med/Low |
| Income | [range] | High/Med/Low |
| Education | [level] | High/Med/Low |
| Occupation | [types] | High/Med/Low |
| Family Status | [single/married/parents] | High/Med/Low |
### Secondary Audience
| Attribute | Profile | Notes |
|-----------|---------|-------|
| [attributes] | [values] | [notes] |
### Demographic Insights
**Key Findings**:
1. [Insight about age/generation]
2. [Insight about location/culture]
3. [Insight about life stage]
**Implications for Influencer Selection**:
- Look for influencers aged [range] who resonate with [demographic]
- Prioritize creators in [locations/markets]
- Consider [family/lifestyle] focused content creators
```
## A3 — Profile Psychographics
```markdown
## Psychographic Profile
### Values & Beliefs
| Value | Importance | How It Manifests |
|-------|------------|------------------|
| [Value 1] | High | [Behavior/preference] |
| [Value 2] | High | [Behavior/preference] |
| [Value 3] | Medium | [Behavior/preference] |
### Interests & Hobbies
**Primary Interests** (directly related to product):
- [Interest 1] - [relevance]
- [Interest 2] - [relevance]
**Adjacent Interests** (lifestyle/cultural):
- [Interest 1] - [connection to brand]
- [Interest 2] - [connection to brand]
### Lifestyle Characteristics
**Daily Life**:
- Morning routine: [description]
- Work/life balance: [description]
- Leisure time: [how they spend it]
- Social habits: [description]
**Aspiration Profile**:
- Who they aspire to be: [description]
- Brands they admire: [brands]
- Lifestyle they want: [description]
### Personality Traits
| Trait | Level | Impact on Content |
|-------|-------|-------------------|
| [Trait 1] | High/Med/Low | [How to appeal] |
| [Trait 2] | High/Med/Low | [How to appeal] |
**Implications for Influencer Selection**:
- Partner with creators who embody [values]
- Content should reflect [lifestyle aspirations]
- Avoid influencers who [misaligned traits]
```
## A4 — Map Behavioral Patterns
```markdown
## Behavioral Analysis
### Purchase Behavior
**Decision Journey**:
| Stage | Duration | Key Activities | Influencer Role |
|-------|----------|----------------|-----------------|
| Awareness | [time] | [activities] | [how influencers help] |
| Consideration | [time] | [activities] | [how influencers help] |
| Decision | [time] | [activities] | [how influencers help] |
| Post-Purchase | [time] | [activities] | [how influencers help] |
**Purchase Triggers**:
- [Trigger 1]: [description]
- [Trigger 2]: [description]
- [Trigger 3]: [description]
**Purchase Barriers**:
- [Barrier 1]: [how to overcome]
- [Barrier 2]: [how to overcome]
### Content Consumption
**Daily Media Diet**:
| Time | Activity | Platforms | Content Type |
|------|----------|-----------|--------------|
| Morning | [activity] | [platforms] | [content] |
| Commute | [activity] | [platforms] | [content] |
| Lunch | [activity] | [platforms] | [content] |
| Evening | [activity] | [platforms] | [content] |
| Weekend | [activity] | [platforms] | [content] |
**Content Engagement Patterns**:
- Most active time: [days/times]
- Average session length: [duration]
- Engagement style: [passive viewer/active commenter/sharer]
- Discovery method: [algorithm/search/recommendations]
### Social Behavior
**How They Interact with Influencers**:
- Follow count: [typical range]
- Engagement level: [lurker/occasional/active]
- Trust in recommendations: [low/medium/high]
- UGC creation: [never/occasionally/frequently]
```
## A5 — Analyze Platform Preferences
```markdown
## Platform Analysis
### Platform Priority Matrix
| Platform | Usage Level | Primary Purpose | Best Content Type |
|----------|-------------|-----------------|-------------------|
| Instagram | High/Med/Low | [purpose] | [format] |
| TikTok | High/Med/Low | [purpose] | [format] |
| YouTube | High/Med/Low | [purpose] | [format] |
| Twitter/X | High/Med/Low | [purpose] | [format] |
| LinkedIn | High/Med/Low | [purpose] | [format] |
| Pinterest | High/Med/Low | [purpose] | [format] |
| Twitch | High/Med/Low | [purpose] | [format] |
### Primary Platform Deep-Dive: [Platform]
**Usage Patterns**:
- Time spent: [hours/day]
- Sessions: [frequency]
- Primary activities: [discovery/entertainment/shopping/social]
**Content Preferences**:
- Preferred format: [Stories/Reels/Feed/etc.]
- Content length: [preference]
- Audio: [sound on/off]
**Influencer Relationship**:
- Influencer types followed: [mega/macro/micro/nano]
- Categories: [lifestyle/comedy/educational/etc.]
- Trust level: [how much they trust platform recommendations]
### Platform Recommendation
**Prioritize these platforms**:
1. [Platform 1]: [reason] - [% of budget recommended]
2. [Platform 2]: [reason] - [% of budget recommended]
3. [Platform 3]: [reason] - [% of budget recommended]
**Avoid or deprioritize**:
- [Platform]: [reason]
```
## A6 — Identify Content Preferences
```markdown
## Content Preference Analysis
### Format Preferences
| Format | Preference | Best For | Example |
|--------|------------|----------|---------|
| Short video (<60s) | High/Med/Low | [use case] | [example] |
| Long video (>3min) | High/Med/Low | [use case] | [example] |
| Static images | High/Med/Low | [use case] | [example] |
| Carousel posts | High/Med/Low | [use case] | [example] |
| Stories | High/Med/Low | [use case] | [example] |
| Live streams | High/Med/Low | [use case] | [example] |
| Podcasts | High/Med/Low | [use case] | [example] |
### Content Style Preferences
**Tone that resonates**:
- [Authentic/polished]
- [Humorous/serious]
- [Educational/entertaining]
- [Aspirational/relatable]
**Visual aesthetics**:
- [Minimalist/maximalist]
- [Bright/moody]
- [Professional/casual]
- [Trendy/timeless]
**Storytelling preferences**:
- [Personal stories/product focus]
- [Problem-solution/lifestyle integration]
- [Tutorial/review/unboxing]
### Topics That Engage
| Topic | Interest Level | Content Angle |
|-------|----------------|---------------|
| [Topic 1] | High | [angle] |
| [Topic 2] | High | [angle] |
| [Topic 3] | Medium | [angle] |
### Content Red Flags
**Avoid these approaches**:
- [Approach 1]: [why it fails]
- [Approach 2]: [why it fails]
```
## A7 — Profile Influencer Affinity
```markdown
## Influencer Affinity Analysis
### Influencer Types They Follow
| Type | Popularity | Trust Level | Example Categories |
|------|------------|-------------|-------------------|
| Mega (1M+) | [%] | [level] | [categories] |
| Macro (100K-1M) | [%] | [level] | [categories] |
| Micro (10K-100K) | [%] | [level] | [categories] |
| Nano (<10K) | [%] | [level] | [categories] |
### Why They Follow Influencers
| Motivation | Strength | Implications |
|------------|----------|--------------|
| Entertainment | High/Med/Low | [content strategy] |
| Education | High/Med/Low | [content strategy] |
| Aspiration | High/Med/Low | [content strategy] |
| Deals/Discounts | High/Med/Low | [content strategy] |
| Community | High/Med/Low | [content strategy] |
| FOMO | High/Med/Low | [content strategy] |
### Trust Factors
**What builds credibility**:
1. [Factor 1]: [explanation]
2. [Factor 2]: [explanation]
3. [Factor 3]: [explanation]
**What destroys trust**:
1. [Factor 1]: [why it fails]
2. [Factor 2]: [why it fails]
### Ideal Influencer Profile
Based on audience analysis, ideal influencers should:
- **Be aged**: [range]
- **Have aesthetic**: [style description]
- **Create content about**: [topics]
- **Communicate with**: [tone/style]
- **Have engagement rate**: [minimum %]
- **Be on**: [priority platforms]
- **Avoid**: [red flags]
```
## A8 — Generate Audience Persona
```markdown
## Audience Persona
### "[Persona Name]"
**Demographics**:
- Age: [X]
- Location: [city/region]
- Occupation: [job]
- Income: [range]
- Family: [status]
**Bio**:
[2-3 sentence description of who they are]
**A Day in Their Life**:
[Brief narrative of typical day including media consumption]
**Goals & Challenges**:
- Goals: [what they want to achieve]
- Challenges: [what stands in their way]
- How [product] helps: [connection]
**Media Consumption**:
- Primary platform: [platform]
- Content preferences: [types]
- Influencers they follow: [examples/types]
- Trust triggers: [what makes them believe]
**Purchase Journey**:
- Discovery: [how they find products]
- Research: [how they evaluate]
- Decision: [what tips them over]
- Loyalty: [what keeps them]
**Key Quote**:
> "[A quote this persona might say about the product/category]"
```
## A9 — Summarize Influencer Selection Criteria
```markdown
# Audience Analysis Summary
## Key Audience Insights
1. [Most important insight]
2. [Second insight]
3. [Third insight]
## Influencer Selection Criteria
### Must-Have Criteria
| Criterion | Requirement | Reasoning |
|-----------|-------------|-----------|
| Audience age | [range] | Matches target demographic |
| Platform | [platforms] | Where audience is active |
| Content style | [style] | Resonates with preferences |
| Engagement rate | [min %] | Indicates active audience |
| Values alignment | [values] | Matches audience beliefs |
### Nice-to-Have Criteria
| Criterion | Preference | Reasoning |
|-----------|------------|-----------|
| [criterion] | [preference] | [reason] |
### Red Flags to Avoid
- [Red flag 1]
- [Red flag 2]
- [Red flag 3]
## Recommended Influencer Mix
| Tier | % of Budget | Quantity | Role |
|------|-------------|----------|------|
| Mega (1M+) | [%] | [#] | Awareness/credibility |
| Macro (100K-1M) | [%] | [#] | Reach + engagement |
| Micro (10K-100K) | [%] | [#] | Trust + conversion |
| Nano (<10K) | [%] | [#] | Authenticity + UGC |
## Next Steps
1. Feed these criteria to [influencer-discovery](../../influencer-discovery/SKILL.md)
2. Score candidates with [fit-scorer](../../fit-scorer/SKILL.md)
```
### Worked example — premium skincare, millennial women (audience mode)
**User**: "Analyze the target audience for a premium skincare brand targeting millennial women."
**Output**: a full analysis following A2–A9 — demographic and psychographic profiles for millennial women, a platform-priority matrix favoring Instagram and TikTok, a named persona, and a must-have/nice-to-have/red-flag selection set sized to a mega/macro/micro/nano budget mix. Saved under `memory/influencer/audience-mapper/`, with age range, priority platforms, and persona name promoted to the hot cache.
---
# niche mode (§N2–N7)
## N2 — Map the Community
```markdown
## Community Overview
### Niche Profile
**Name**: [community name/identifier]
**Size Estimate**: [community size]
**Growth Trend**: [growing/stable/declining]
**Primary Platforms**: [where they gather]
**Secondary Platforms**: [other presence]
### Community Demographics
| Attribute | Profile | Notes |
|-----------|---------|-------|
| Age range | [range] | [notes] |
| Gender split | [%] | [notes] |
| Location | [regions] | [notes] |
| Income | [range] | [notes] |
| Occupation | [typical jobs] | [notes] |
### Community Psychographics
**Core Identity**:
- How they describe themselves: "[self-description]"
- What unites them: [shared passion/belief/activity]
- What they're against: [opposition identity]
**Values Hierarchy**:
1. [Top value]: [why it matters]
2. [Second value]: [why it matters]
3. [Third value]: [why it matters]
### Sub-communities
| Sub-niche | Size | Focus | Key Difference |
|-----------|------|-------|----------------|
| [sub 1] | [size] | [focus] | [how it differs] |
| [sub 2] | [size] | [focus] | [how it differs] |
```
## N3 — Analyze Community Culture
```markdown
## Cultural Analysis
### Language & Terminology
**Key Terms to Know**:
| Term | Meaning | Usage Context |
|------|---------|---------------|
| [term 1] | [meaning] | [how/when used] |
| [term 2] | [meaning] | [how/when used] |
| [term 3] | [meaning] | [how/when used] |
**Insider Language Examples**:
- "[phrase]" = [translation]
- "[phrase]" = [translation]
**Language to Avoid**:
- "[term]" - [why it's problematic]
- "[term]" - [why it's problematic]
### Community Norms
**Unwritten Rules**:
1. **[Rule 1]**: [explanation]
- Do: [example]
- Don't: [example]
2. **[Rule 2]**: [explanation]
- Do: [example]
- Don't: [example]
### Status & Credibility
**How credibility is earned**:
- [Factor 1]: [explanation]
- [Factor 2]: [explanation]
- [Factor 3]: [explanation]
**Status markers**:
- [Marker 1]: [what it signals]
- [Marker 2]: [what it signals]
### Content Culture
**Celebrated content types**:
- [Type 1]: [why it's valued]
- [Type 2]: [why it's valued]
**Content taboos**:
- [Taboo 1]: [why it's rejected]
- [Taboo 2]: [why it's rejected]
### Brand Attitudes
**How community views brands**:
- General attitude: [positive/neutral/skeptical/hostile]
- Brands that succeeded: [examples and why]
- Brands that failed: [examples and why]
**What earns brand acceptance**:
- [Factor 1]
- [Factor 2]
**What triggers rejection**:
- [Factor 1]
- [Factor 2]
```
## N4 — Identify Key Voices
```markdown
## Key Community Voices
### Tier 1: Community Leaders
| Creator | Platform | Followers | Why They Matter |
|---------|----------|-----------|-----------------|
| @[handle1] | [platform] | [count] | [influence description] |
| @[handle2] | [platform] | [count] | [influence description] |
**Deep Dive: [Top Creator]**
- **Handle**: @[handle]
- **Platforms**: [platforms]
- **Content focus**: [topics]
- **Engagement rate**: [%]
- **Community standing**: [description]
- **Brand history**: [past partnerships]
- **Partnership potential**: [assessment]
### Tier 2: Rising Stars
| Creator | Platform | Followers | Growth Rate | Specialty |
|---------|----------|-----------|-------------|-----------|
| @[handle] | [platform] | [count] | [% growth] | [focus] |
### Tier 3: Micro-Voices
| Creator | Sub-niche | Followers | Engagement | Value |
|---------|-----------|-----------|------------|-------|
| @[handle] | [niche] | [count] | [rate] | [what they offer] |
### Voice Map
Sketch the influence structure: Tier 1 leaders → core community; rising stars → growing segment; micro-voices → niche segments.
### Collaboration Networks
**Who collaborates with whom**:
- [Creator A] often works with [Creator B]
- [Group/collective] includes: [members]
- Cross-platform presence: [who's on multiple platforms]
```
## N5 — Map Content Ecosystem
```markdown
## Content Ecosystem
### Top Performing Content Types
| Content Type | Platform | Avg Engagement | Example |
|--------------|----------|----------------|---------|
| [type 1] | [platform] | [rate] | [example] |
| [type 2] | [platform] | [rate] | [example] |
### Content Themes
**Evergreen topics** (always relevant):
- [Topic 1]: [why it resonates]
**Trending topics** (current):
- [Topic 1]: [current conversation]
**Controversial topics** (handle carefully):
- [Topic 1]: [different perspectives]
### Content Formats
**High Performance**:
| Format | Platform | Why It Works | Brand Application |
|--------|----------|--------------|-------------------|
| [format] | [platform] | [reason] | [how brand can use] |
**Declining/Saturated**:
- [Format]: [why it's declining]
### Hashtags & Discovery
**Community hashtags**:
| Hashtag | Volume | Community Meaning |
|---------|--------|-------------------|
| #[tag1] | [posts] | [significance] |
**Discovery pathways**:
- How content spreads: [mechanism]
- Cross-posting patterns: [platforms]
- Algorithm factors: [what gets boosted]
```
## N6 — Assess Opportunities & Risks (Brand Fit Score)
```markdown
## Opportunity Assessment
### Market Opportunity
| Factor | Assessment | Notes |
|--------|------------|-------|
| Community size | [size] | [growing/stable/shrinking] |
| Brand saturation | [low/medium/high] | [competitor presence] |
| Purchase intent | [low/medium/high] | [buying behavior] |
| Price sensitivity | [low/medium/high] | [spending patterns] |
| Engagement quality | [low/medium/high] | [interaction depth] |
### Brand Fit Score
| Factor | Score (1-5) | Explanation |
|--------|-------------|-------------|
| Value alignment | [score] | [explanation] |
| Audience overlap | [score] | [explanation] |
| Product relevance | [score] | [explanation] |
| Content fit | [score] | [explanation] |
| Price point fit | [score] | [explanation] |
| **Total** | [X/25] | |
**Fit Assessment**: [Strong/Moderate/Weak/Poor]
> This X/25 is a niche-entry go/no-go for the community. It is **not** the C³ ACE creator score or the CVI — those are computed downstream by fit-scorer and roi-calculator, not here.
### Risk Assessment
| Risk | Likelihood | Impact | Mitigation |
|------|------------|--------|------------|
| [Risk 1] | High/Med/Low | High/Med/Low | [how to mitigate] |
| [Risk 2] | High/Med/Low | High/Med/Low | [how to mitigate] |
**Cultural Sensitivities**:
- [Sensitivity 1]: [how to navigate]
- [Sensitivity 2]: [how to navigate]
### Competitive Map
| Competitor | Niche Presence | Strategy | Performance |
|------------|----------------|----------|-------------|
| [comp 1] | [level] | [approach] | [results] |
**White Space Opportunities**:
- [Opportunity 1]: [description]
```
## N7 — Generate Entry Strategy
```markdown
## Niche Entry Strategy
### Recommended Approach
**Strategy Type**: [Immersion/Partnership/Sponsorship/Content]
**Rationale**: [why this approach]
### Phase 1: Listen & Learn (Weeks 1-2)
- Follow key voices: [list]
- Monitor conversations: [topics]
- Note language patterns: [terminology]
- Identify content gaps: [opportunities]
### Phase 2: Soft Entry (Weeks 3-4)
- Initial creator partnerships: [recommended creators]
- Content approach: [format and style]
- Community touchpoints: [where to engage]
### Phase 3: Active Engagement (Month 2+)
- Expanded creator roster: [additional partners]
- Community participation: [how to contribute]
- Content cadence: [frequency]
### Creator Partnership Recommendations
**Must-Partner (High priority)**:
| Creator | Platform | Why | Approach |
|---------|----------|-----|----------|
| @[handle] | [platform] | [reason] | [how to approach] |
**Should-Consider (Medium priority)**:
| Creator | Platform | Why | Approach |
|---------|----------|-----|----------|
| @[handle] | [platform] | [reason] | [how to approach] |
### Content Strategy
**Themes to emphasize**:
- [Theme 1]: [content angle]
**Formats to use**:
- [Format 1]: [why it works here]
**Avoid**:
- [Content type]: [why it won't work]
### Success Metrics
| Metric | Target | Timeline |
|--------|--------|----------|
| [metric 1] | [target] | [when] |
### Red Lines
Things that would damage brand reputation in this community:
- [Red line 1]
- [Red line 2]
```
### Worked example — #BookTok for a publishing brand (niche mode)
**User**: "Research the #BookTok community for a publishing brand."
**Output**: a niche dossier on BookTok — community culture, key voices (e.g. @aikitwokki), content types that perform (book reviews, reading vlogs, shelfies), insider language ("booktok made me buy it"), a Brand Fit Score with verdict, and phased partnership recommendations for the publisher. Niche name, brand-fit verdict, top 3 voices, and hard red lines promoted to the hot cache.
---
## Tips for Success
1. **Use real data when available** — customer surveys, social insights, sales data, real community language.
2. **Don't assume** — validate hypotheses; mark inferred attributes with a confidence level.
3. **Consider micro-segments** (audience) and sub-niches (niche) — not all of an audience is the same.
4. **Learn the language before you enter** (niche) — authenticity requires fluency; every community has sacred cows.
5. **Add value, don't extract** — communities reject exploitation; start with respected voices, since credibility transfers.
6. **Connect every insight to selection** — each finding should inform which creators to pick and how to brief them.
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| add-product-e2e-evalpaperclipai/paperclipAdd or extend a Paperclip full-stack runner E2E workflow, fixture, matcher, or report evidence path for local or Daytona execution. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| diagnose-why-work-stoppedpaperclipai/paperclipCompatibility entry point for failed, stalled, looping, or over-recovered Paperclip work. Use fix-failed-paperclip-run for the full diagnosis, regression, repair, real verification, and green-PR workflow; honor an explicitly requested diagnosis-only scope. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |
| fix-failed-paperclip-runpaperclipai/paperclipDiagnose and fix failed, stuck, slow, or incorrectly blocked Paperclip tasks and runs. Use with a task/run URL or failure report to trace the root cause, prove a regression red then green, check second-order effects, verify the real workflow, and deliver a PR with passing checks. | Stars: 115k | Updated | Claude CodeCodex | Verified | Install |