Developer Audience Context
When to Use
Use this skill when you need 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...
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:
1---2name: developer-audience-context3description: 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.4---567# Developer Audience Context8## When to Use910Use this skill when you need 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...111213This 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.1415---1617## Before You Start1819Check if `.agents/developer-audience-context.md` exists:2021- **If it exists**: Read it and offer to update specific sections22- **If it doesn't exist**: Create the directory and file, then walk through each section2324---2526## Two Ways to Build Context2728### Option 1: Auto-Draft from Codebase (Recommended)2930Analyze existing materials to draft an initial version:31321. **README.md** — Product description, features, getting started332. **Documentation** — `/docs`, API reference, tutorials343. **Landing pages** — `index.html`, marketing copy354. **package.json / pyproject.toml** — Dependencies reveal ecosystem365. **GitHub Issues** — Common questions, frustrations, use cases376. **Existing blog posts** — Technical content, tutorials3839After drafting, walk through each section to validate and fill gaps.4041### Option 2: Start from Scratch4243Ask questions section-by-section. Don't advance until the current section is complete.4445---4647## The 10 Sections to Capture4849### 1. Product Overview5051| Field | What to capture |52|-------|-----------------|53| Product name | Official name and any aliases |54| One-liner | "We help [developers] do [X] without [Y]" |55| Category | API, SDK, CLI, SaaS, open source library, infrastructure |56| Core technology | Languages, frameworks, platforms supported |57| Pricing model | Free/open source, freemium, usage-based, seat-based |5859### 2. Developer Persona6061Not "developers" generically — get specific:6263| Field | What to capture |64|-------|-----------------|65| Primary role | Backend, frontend, full-stack, DevOps, data, ML, mobile |66| Seniority | Junior, mid, senior, staff, lead, architect |67| Company size | Solo, startup, scale-up, enterprise |68| Industry verticals | Fintech, healthtech, e-commerce, gaming, B2B SaaS |69| Tech stack | Languages, frameworks, cloud providers they use |70| Decision authority | Individual contributor, team lead, buyer, influencer |7172**Ask**: "Describe the developer who gets the most value from your product in one paragraph. What's their day-to-day like?"7374### 3. Where They Hang Out7576Developers research before they buy. Know where:7778| Channel | Specifics to capture |79|---------|---------------------|80| Communities | Specific subreddits, Discord servers, Slack groups |81| Social | Twitter/X hashtags, LinkedIn groups |82| Content | Blogs they read, newsletters they subscribe to, podcasts |83| Events | Conferences, meetups, hackathons |84| Code | GitHub topics, Stack Overflow tags |8586**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.8788### 4. Problems & Pain Points8990Capture the actual problems, not your solution's features:9192| Level | What to capture |93|-------|-----------------|94| Functional | "I can't do X" / "X takes too long" / "X is error-prone" |95| Emotional | Frustration, anxiety, embarrassment, fear |96| Situational | When does the pain occur? What triggers the search? |9798**Ask**: "What's the #1 frustration that brings developers to you?"99100**Research**: Search Reddit, Hacker News, and Stack Overflow for complaints about your problem space. Capture verbatim quotes.101102### 5. Current Alternatives103104What are developers using today instead of you?105106| Alternative type | Examples |107|-----------------|----------|108| Direct competitors | Tools that solve the same problem |109| DIY / build it yourself | Custom scripts, internal tools |110| Indirect solutions | Workarounds, manual processes |111| Do nothing | Live with the pain |112113For each alternative, capture:114- Why developers choose it115- What's frustrating about it116- What would make them switch117118### 6. Key Differentiators119120What makes you different — in developer terms:121122| Differentiator type | Example |123|--------------------|---------|124| Technical | "10x faster," "No dependencies," "Type-safe" |125| DX (Developer Experience) | "5-minute setup," "Great docs," "First-class CLI" |126| Ecosystem | "Works with X," "Built for Y framework" |127| Philosophy | "Open source," "Privacy-first," "Local-first" |128129**Warning**: Avoid marketing fluff. Developers see through "best-in-class" and "enterprise-grade." Use specific, provable claims.130131### 7. Verbatim Developer Language132133Capture exact phrases developers use — not polished marketing copy:134135| Category | Examples |136|----------|---
sickn33