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:

1. README.md — Product description, features, getting started
2. Documentation — /docs, API reference, tutorials
3. Landing pages — index.html, marketing copy
4. package.json / pyproject.toml — Dependencies reveal ecosystem
5. GitHub Issues — Common questions, frustrations, use cases
6. 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

2. Developer Persona

Not "developers" generically — get specific:

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:

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:

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?

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:

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:

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:

9. Conversion Actions

What does success look like at each stage?

10. Voice & Tone

How should you sound when talking to these developers?

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

Related Skills

After establishing context, these skills will reference it:

• devrel-content — Writing content that resonates
• hacker-news-strategy — Engaging on HN authentically
• developer-onboarding — Optimizing time-to-value
• developer-seo — Targeting the right technical queries
• competitor-tracking — Understanding your competitive landscape

Limitations

• Use this skill only when the task clearly matches its upstream source and local project context.
• Verify commands, generated code, dependencies, credentials, and external service behavior before applying changes.
• Do not treat examples as a substitute for environment-specific tests, security review, or user approval for destructive or costly actions.