Developer Audience Context
This skill helps you create and maintain .agents/developer-audience-context.md — a foundational document that captures everything about your target developers. All other developer marketing skills reference this document first, so you only define your audience once.
Before You Start
Check if .agents/developer-audience-context.md exists:
- If it exists: Read it and offer to update specific sections
- If it doesn't exist: Create the directory and file, then walk through each section
Two Ways to Build Context
Option 1: Auto-Draft from Codebase (Recommended)
Analyze existing materials to draft an initial version:
- README.md — Product description, features, getting started
- Documentation —
/docs, API reference, tutorials
- Landing pages —
index.html, marketing copy
- package.json / pyproject.toml — Dependencies reveal ecosystem
- GitHub Issues — Common questions, frustrations, use cases
- Existing blog posts — Technical content, tutorials
After drafting, walk through each section to validate and fill gaps.
Option 2: Start from Scratch
Ask questions section-by-section. Don't advance until the current section is complete.
The 10 Sections to Capture
1. Product Overview
| Field |
What to capture |
| Product name |
Official name and any aliases |
| One-liner |
"We help [developers] do [X] without [Y]" |
| Category |
API, SDK, CLI, SaaS, open source library, infrastructure |
| Core technology |
Languages, frameworks, platforms supported |
| Pricing model |
Free/open source, freemium, usage-based, seat-based |
2. Developer Persona
Not "developers" generically — get specific:
| Field |
What to capture |
| Primary role |
Backend, frontend, full-stack, DevOps, data, ML, mobile |
| Seniority |
Junior, mid, senior, staff, lead, architect |
| Company size |
Solo, startup, scale-up, enterprise |
| Industry verticals |
Fintech, healthtech, e-commerce, gaming, B2B SaaS |
| Tech stack |
Languages, frameworks, cloud providers they use |
| Decision authority |
Individual contributor, team lead, buyer, influencer |
Ask: "Describe the developer who gets the most value from your product in one paragraph. What's their day-to-day like?"
3. Where They Hang Out
Developers research before they buy. Know where:
| Channel |
Specifics to capture |
| Communities |
Specific subreddits, Discord servers, Slack groups |
| Social |
Twitter/X hashtags, LinkedIn groups |
| Content |
Blogs they read, newsletters they subscribe to, podcasts |
| Events |
Conferences, meetups, hackathons |
| Code |
GitHub topics, Stack Overflow tags |
Pro tip: Use social listening tools to monitor conversations across Hacker News, Reddit, Stack Overflow, GitHub, and Twitter. See where discussions about your problem space happen organically.
4. Problems & Pain Points
Capture the actual problems, not your solution's features:
| Level |
What to capture |
| Functional |
"I can't do X" / "X takes too long" / "X is error-prone" |
| Emotional |
Frustration, anxiety, embarrassment, fear |
| Situational |
When does the pain occur? What triggers the search? |
Ask: "What's the #1 frustration that brings developers to you?"
Research: Search Reddit, Hacker News, and Stack Overflow for complaints about your problem space. Capture verbatim quotes.
5. Current Alternatives
What are developers using today instead of you?
| Alternative type |
Examples |
| Direct competitors |
Tools that solve the same problem |
| DIY / build it yourself |
Custom scripts, internal tools |
| Indirect solutions |
Workarounds, manual processes |
| Do nothing |
Live with the pain |
For each alternative, capture:
- Why developers choose it
- What's frustrating about it
- What would make them switch
6. Key Differentiators
What makes you different — in developer terms:
| Differentiator type |
Example |
| Technical |
"10x faster," "No dependencies," "Type-safe" |
| DX (Developer Experience) |
"5-minute setup," "Great docs," "First-class CLI" |
| Ecosystem |
"Works with X," "Built for Y framework" |
| Philosophy |
"Open source," "Privacy-first," "Local-first" |
Warning: Avoid marketing fluff. Developers see through "best-in-class" and "enterprise-grade." Use specific, provable claims.
7. Verbatim Developer Language
Capture exact phrases developers use — not polished marketing copy:
| Category |
Examples |
| Describing the problem |
"This is such a pain," "I wish I could just..." |
| Describing your product |
How they explain it to others |
| Objections |
"But what about...", "I'm worried that..." |
| Praise |
Testimonials, tweets, GitHub comments |
Sources: GitHub issues, Twitter mentions, Hacker News comments, support tickets, sales calls, community Slack/Discord.
8. Technical Trust Signals
What proof points matter to developers:
| Signal type |
Examples |
| Adoption |
GitHub stars, npm downloads, Docker pulls |
| Quality |
Test coverage, security audits, uptime SLA |
| Community |
Contributors, Discord members, forum activity |
| Credibility |
Backed by X, used by Y, created by Z |
| Transparency |
Open source, public roadmap, changelog |
9. Conversion Actions
What does success look like at each stage?
| Stage |
Primary action |
Secondary actions |
| Awareness |
Star repo, follow on Twitter |
Read blog post, share content |
| Consideration |
Clone repo, read docs |
Watch demo, join Discord |
| Trial |
Sign up, install SDK |
Complete quickstart, make first API call |
| Activation |
Reach "Hello World" moment |
Integrate into real project |
| Conversion |
Upgrade to paid |
Add team members, expand usage |
10. Voice & Tone
How should you sound when talking to these developers?
| Dimension |
Spectrum |
| Formality |
Casual ← → Professional |
| Technicality |
Accessible ← → Deep technical |
| Personality |
Neutral ← → Opinionated |
| Humor |
Serious ← → Playful |
Examples:
- Stripe → Professional, precise, clean
- Vercel → Modern, confident, developer-first
- Supabase → Friendly, accessible, community-driven
- Tailwind → Opinionated, direct, practical
Output Format
Save to .agents/developer-audience-context.md with this structure:
# Developer Audience Context
Last updated: [DATE]
## Product Overview
[Section content]
## Developer Persona
[Section content]
## Where They Hang Out
[Section content]
## Problems & Pain Points
[Section content]
## Current Alternatives
[Section content]
## Key Differentiators
[Section content]
## Verbatim Developer Language
[Section content]
## Technical Trust Signals
[Section content]
## Conversion Actions
[Section content]
## Voice & Tone
[Section content]
Maintenance
Update this document when:
- You learn something new from user research
- You find great verbatim quotes
- Your positioning or differentiation changes
- You expand to new developer segments
Tools
| Tool |
Use case |
| Octolens |
Monitor developer conversations across GitHub, Hacker News, Reddit, Stack Overflow, Twitter. Essential for capturing verbatim language, finding pain points, and understanding where your developers hang out. |
| GitHub Search |
Find how developers describe problems in issues |
| Twitter Advanced Search |
Find discussions about your space |
| Google Alerts |
Track mentions of competitors and problem keywords |
Related Skills
After establishing context, these skills will reference it:
devrel-content — Writing content that resonateshacker-news-strategy — Engaging on HN authenticallydeveloper-onboarding — Optimizing time-to-valuedeveloper-seo — Targeting the right technical queriescompetitor-tracking — Understanding your competitive landscape
1---2name: developer-audience-context-23description: When the user wants to establish or update their developer audience context. Also use when starting any other developer marketing skill to ensure foundational context is loaded. Trigger phrases include "developer persona," "target developers," "who are our developers," "developer profile," "ICP," or "ideal customer profile."4---56# Developer Audience Context78This skill helps you create and maintain `.agents/developer-audience-context.md` — a foundational document that captures everything about your target developers. All other developer marketing skills reference this document first, so you only define your audience once.910---1112## Before You Start1314Check if `.agents/developer-audience-context.md` exists:1516- **If it exists**: Read it and offer to update specific sections17- **If it doesn't exist**: Create the directory and file, then walk through each section1819---2021## Two Ways to Build Context2223### Option 1: Auto-Draft from Codebase (Recommended)2425Analyze existing materials to draft an initial version:26271. **README.md** — Product description, features, getting started282. **Documentation** — `/docs`, API reference, tutorials293. **Landing pages** — `index.html`, marketing copy304. **package.json / pyproject.toml** — Dependencies reveal ecosystem315. **GitHub Issues** — Common questions, frustrations, use cases326. **Existing blog posts** — Technical content, tutorials3334After drafting, walk through each section to validate and fill gaps.3536### Option 2: Start from Scratch3738Ask questions section-by-section. Don't advance until the current section is complete.3940---4142## The 10 Sections to Capture4344### 1. Product Overview4546| Field | What to capture |47|-------|-----------------|48| Product name | Official name and any aliases |49| One-liner | "We help [developers] do [X] without [Y]" |50| Category | API, SDK, CLI, SaaS, open source library, infrastructure |51| Core technology | Languages, frameworks, platforms supported |52| Pricing model | Free/open source, freemium, usage-based, seat-based |5354### 2. Developer Persona5556Not "developers" generically — get specific:5758| Field | What to capture |59|-------|-----------------|60| Primary role | Backend, frontend, full-stack, DevOps, data, ML, mobile |61| Seniority | Junior, mid, senior, staff, lead, architect |62| Company size | Solo, startup, scale-up, enterprise |63| Industry verticals | Fintech, healthtech, e-commerce, gaming, B2B SaaS |64| Tech stack | Languages, frameworks, cloud providers they use |65| Decision authority | Individual contributor, team lead, buyer, influencer |6667**Ask**: "Describe the developer who gets the most value from your product in one paragraph. What's their day-to-day like?"6869### 3. Where They Hang Out7071Developers research before they buy. Know where:7273| Channel | Specifics to capture |74|---------|---------------------|75| Communities | Specific subreddits, Discord servers, Slack groups |76| Social | Twitter/X hashtags, LinkedIn groups |77| Content | Blogs they read, newsletters they subscribe to, podcasts |78| Events | Conferences, meetups, hackathons |79| Code | GitHub topics, Stack Overflow tags |8081**Pro tip**: Use social listening tools to monitor conversations across Hacker News, Reddit, Stack Overflow, GitHub, and Twitter. See where discussions about your problem space happen organically.8283### 4. Problems & Pain Points8485Capture the actual problems, not your solution's features:8687| Level | What to capture |88|-------|-----------------|89| Functional | "I can't do X" / "X takes too long" / "X is error-prone" |90| Emotional | Frustration, anxiety, embarrassment, fear |91| Situational | When does the pain occur? What triggers the search? |9293**Ask**: "What's the #1 frustration that brings developers to you?"9495**Research**: Search Reddit, Hacker News, and Stack Overflow for complaints about your problem space. Capture verbatim quotes.9697### 5. Current Alternatives9899What are developers using today instead of you?100101| Alternative type | Examples |102|-----------------|----------|103| Direct competitors | Tools that solve the same problem |104| DIY / build it yourself | Custom scripts, internal tools |105| Indirect solutions | Workarounds, manual processes |106| Do nothing | Live with the pain |107108For each alternative, capture:109- Why developers choose it110- What's frustrating about it111- What would make them switch112113### 6. Key Differentiators114115What makes you different — in developer terms:116117| Differentiator type | Example |118|--------------------|---------|119| Technical | "10x faster," "No dependencies," "Type-safe" |120| DX (Developer Experience) | "5-minute setup," "Great docs," "First-class CLI" |121| Ecosystem | "Works with X," "Built for Y framework" |122| Philosophy | "Open source," "Privacy-first," "Local-first" |123124**Warning**: Avoid marketing fluff. Developers see through "best-in-class" and "enterprise-grade." Use specific, provable claims.125126### 7. Verbatim Developer Language127128Capture exact phrases developers use — not polished marketing copy:129130| Category | Examples |131|----------|----------|132| Describing the problem | "This is such a pain," "I wish I could just..." |133| Describing your product | How they explain it to others |134| Objections | "But what about...", "I'm worried that..." |135| Praise | Testimonials, tweets, GitHub comments |136137**Sources**: GitHub issues, Twitter mentions, Hacker News comments, support tickets, sales calls, community Slack/Discord.138139### 8. Technical Trust Signals140141What proof points matter to developers:142143| Signal type | Examples |144|-------------|----------|145| Adoption | GitHub stars, npm downloads, Docker pulls |146| Quality | Test coverage, security audits, uptime SLA |147| Community | Contributors, Discord members, forum activity |148| Credibility | Backed by X, used by Y, created by Z |149| Transparency | Open source, public roadmap, changelog |150151### 9. Conversion Actions152153What does success look like at each stage?154155| Stage | Primary action | Secondary actions |156|-------|---------------|-------------------|157| Awareness | Star repo, follow on Twitter | Read blog post, share content |158| Consideration | Clone repo, read docs | Watch demo, join Discord |159| Trial | Sign up, install SDK | Complete quickstart, make first API call |160| Activation | Reach "Hello World" moment | Integrate into real project |161| Conversion | Upgrade to paid | Add team members, expand usage |162163### 10. Voice & Tone164165How should you sound when talking to these developers?166167| Dimension | Spectrum |168|-----------|----------|169| Formality | Casual ← → Professional |170| Technicality | Accessible ← → Deep technical |171| Personality | Neutral ← → Opinionated |172| Humor | Serious ← → Playful |173174**Examples**:175- Stripe → Professional, precise, clean176- Vercel → Modern, confident, developer-first177- Supabase → Friendly, accessible, community-driven178- Tailwind → Opinionated, direct, practical179180---181182## Output Format183184Save to `.agents/developer-audience-context.md` with this structure:185186```markdown187# Developer Audience Context188189Last updated: [DATE]190191## Product Overview192[Section content]193194## Developer Persona195[Section content]196197## Where They Hang Out198[Section content]199200## Problems & Pain Points201[Section content]202203## Current Alternatives204[Section content]205206## Key Differentiators207[Section content]208209## Verbatim Developer Language210[Section content]211212## Technical Trust Signals213[Section content]214215## Conversion Actions216[Section content]217218## Voice & Tone219[Section content]220```221222---223224## Maintenance225226Update this document when:227228- You learn something new from user research229- You find great verbatim quotes230- Your positioning or differentiation changes231- You expand to new developer segments232233---234235## Tools236237| Tool | Use case |238|------|----------|239| **[Octolens](https://octolens.com)** | Monitor developer conversations across GitHub, Hacker News, Reddit, Stack Overflow, Twitter. Essential for capturing verbatim language, finding pain points, and understanding where your developers hang out. |240| **GitHub Search** | Find how developers describe problems in issues |241| **Twitter Advanced Search** | Find discussions about your space |242| **Google Alerts** | Track mentions of competitors and problem keywords |243244---245246## Related Skills247248After establishing context, these skills will reference it:249250- `devrel-content` — Writing content that resonates251- `hacker-news-strategy` — Engaging on HN authentically252- `developer-onboarding` — Optimizing time-to-value253- `developer-seo` — Targeting the right technical queries254- `competitor-tracking` — Understanding your competitive landscape
jonathimer