Skip to content

aiskillstore/marketplace / skills/aaron-he-zhu/audience-mapper

audience-mapper

Verified

Use 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. 目标受众画像/人群分析 · 细分社群/亚文化调研

FileKindSize
SKILL.mdskill md13.6 KB
references/templates.mdmarkdown20.8 KB
skill-report.jsonconfig37.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.
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: 115kUpdated Claude CodeCodexVerifiedInstall
add-runner-evalpaperclipai/paperclipAdd or extend a Paperclip Runner protocol evaluation definition, roster, assertion, or report fixture with provenance and narrow validation.Stars: 115kUpdated Claude CodeCodexVerifiedInstall
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: 115kUpdated Claude CodeCodexVerifiedInstall
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: 115kUpdated Claude CodeCodexVerifiedInstall