Developer Newsletter
When to Use
Use this skill when you need when the user wants to create, write, or improve a newsletter for developer audiences. Trigger phrases include "newsletter," "email marketing," "developer email," "weekly digest," "dev newsletter," "email subscribers," "newsletter growth," or "email list.".
This skill helps you build and write newsletters that developers actually open, read, and look forward to receiving. Covers content strategy, writing, growth, and deliverability.
Before You Start
Load your audience context first. Read .agents/developer-audience-context.md to understand:
- Who you're writing for (role, seniority, tech stack)
- What content resonates (problems, interests)
- Where else they consume content (to avoid duplicate effort)
- Voice & tone (how casual/technical)
If the context file doesn't exist, run the developer-audience-context skill first.
Newsletter Strategy
Define Your Newsletter Type
| Type |
Description |
Example |
| Product updates |
Changelog, new features, tips |
Vercel's updates |
| Curated links |
Best content from around the web |
TLDR, Bytes |
| Original content |
Your own articles, tutorials |
Cassidy Williams |
| Community digest |
What happened in your community |
Dev community roundups |
| Educational series |
Teaching a topic over time |
Course-style newsletters |
Best practice: Pick ONE primary type. You can mix in others, but have a clear identity.
Frequency Matrix
| Frequency |
Best For |
Risk |
| Daily |
Curated links, news |
Fatigue, hard to maintain |
| Weekly |
Most newsletters |
Sweet spot for most |
| Bi-weekly |
Original content heavy |
Can lose momentum |
| Monthly |
Product updates, digests |
Easy to forget you exist |
Developer preference: Weekly is the sweet spot. Developers are busy and inbox-protective.
Content Mix Framework
The 70-20-10 Rule
| Percentage |
Content Type |
Purpose |
| 70% |
Value content |
Teach, inform, help |
| 20% |
Product content |
Updates, features, how-tos |
| 10% |
Promotional |
CTAs, asks, sales |
Content Categories
Build a rotation of these:
| Category |
Examples |
| Tutorials |
"How to implement X" |
| News analysis |
"What Y announcement means for you" |
| Tool/library roundups |
"5 libraries for handling Z" |
| Code snippets |
"Quick tip: better error handling" |
| Community highlights |
"Best from our Discord this week" |
| Industry takes |
"Why I think X is overhyped" |
| Behind the scenes |
"How we built feature Y" |
| Q&A |
"You asked, we answered" |
Writing Developer Emails
Subject Line Framework
What works for developers:
| Pattern |
Example |
Why It Works |
| Specific benefit |
"Cut your build time by 40%" |
Concrete value |
| Technical curiosity |
"The JavaScript feature nobody uses" |
Triggers curiosity |
| Direct announcement |
"v2.0 is here: async/await support" |
Clear, newsworthy |
| Number + topic |
"7 TypeScript tricks senior devs use" |
Scannable, specific |
| Question |
"Are you still using callbacks?" |
Pattern interrupt |
| Breaking news |
"React 19 is out: what you need to know" |
Timely, urgent |
What doesn't work:
| Avoid |
Why |
| ALL CAPS |
Spam signals |
| "Quick question" |
Manipulative |
| Excessive emoji |
Looks like marketing |
| "You won't believe..." |
Clickbait fatigue |
| No subject line |
Just... no |
Pre-header Text
The preview text after the subject line. Use it.
| Subject |
Pre-header |
| "v2.0 is here" |
"Plus: breaking changes to watch for" |
| "This week in Node.js" |
"fetch() drama, npm security, and a cool CLI" |
Email Structure
[Short personal intro - 1-2 sentences]
[Main content sections with clear headers]
[Code snippet if relevant]
[Quick links section]
[Sign-off with personality]
Code in Email
Code rendering is tricky in email. Options:
| Approach |
Pros |
Cons |
Inline code (backticks) |
Works everywhere |
No highlighting |
| Plain text block |
Reliable |
Ugly |
| Image of code |
Beautiful |
Can't copy, accessibility issues |
| "View in browser" link |
Full formatting |
Friction |
| Styled HTML tables |
Decent formatting |
Complex, can break |
Recommendation: Keep code short. Use inline code for small snippets, link to full examples.
<pre style="background-color: #1e1e1e; color: #d4d4d4; padding: 16px; border-radius: 4px; font-family: 'Fira Code', monospace; font-size: 14px; overflow-x: auto;">
const result = await fetch('/api/data');
</pre>
Subject Line Testing
A/B Test Framework
Test one variable at a time:
| Variable | Version A | Version
1---2name: developer-newsletter3description: When the user wants to create, write, or improve a newsletter for developer audiences. Trigger phrases include "newsletter," "email marketing," "developer email," "weekly digest," "dev newsletter," "e4category: Document Processing5source: antigravity6tags: [python, javascript, typescript, react, node, markdown, api, ai, agent, automation]7url: https://github.com/sickn33/antigravity-awesome-skills/tree/main/skills/developer-newsletter8metadata:9 source: https://skillmd.com/skills/sickn33/developer-newsletter10---111213# Developer Newsletter14## When to Use1516Use this skill when you need when the user wants to create, write, or improve a newsletter for developer audiences. Trigger phrases include "newsletter," "email marketing," "developer email," "weekly digest," "dev newsletter," "email subscribers," "newsletter growth," or "email list.".171819This skill helps you build and write newsletters that developers actually open, read, and look forward to receiving. Covers content strategy, writing, growth, and deliverability.2021---2223## Before You Start2425**Load your audience context first.** Read `.agents/developer-audience-context.md` to understand:2627- Who you're writing for (role, seniority, tech stack)28- What content resonates (problems, interests)29- Where else they consume content (to avoid duplicate effort)30- Voice & tone (how casual/technical)3132If the context file doesn't exist, run the `developer-audience-context` skill first.3334---3536## Newsletter Strategy3738### Define Your Newsletter Type3940| Type | Description | Example |41|------|-------------|---------|42| **Product updates** | Changelog, new features, tips | Vercel's updates |43| **Curated links** | Best content from around the web | TLDR, Bytes |44| **Original content** | Your own articles, tutorials | Cassidy Williams |45| **Community digest** | What happened in your community | Dev community roundups |46| **Educational series** | Teaching a topic over time | Course-style newsletters |4748**Best practice**: Pick ONE primary type. You can mix in others, but have a clear identity.4950### Frequency Matrix5152| Frequency | Best For | Risk |53|-----------|----------|------|54| **Daily** | Curated links, news | Fatigue, hard to maintain |55| **Weekly** | Most newsletters | Sweet spot for most |56| **Bi-weekly** | Original content heavy | Can lose momentum |57| **Monthly** | Product updates, digests | Easy to forget you exist |5859**Developer preference**: Weekly is the sweet spot. Developers are busy and inbox-protective.6061---6263## Content Mix Framework6465### The 70-20-10 Rule6667| Percentage | Content Type | Purpose |68|------------|--------------|---------|69| **70%** | Value content | Teach, inform, help |70| **20%** | Product content | Updates, features, how-tos |71| **10%** | Promotional | CTAs, asks, sales |7273### Content Categories7475Build a rotation of these:7677| Category | Examples |78|----------|----------|79| **Tutorials** | "How to implement X" |80| **News analysis** | "What Y announcement means for you" |81| **Tool/library roundups** | "5 libraries for handling Z" |82| **Code snippets** | "Quick tip: better error handling" |83| **Community highlights** | "Best from our Discord this week" |84| **Industry takes** | "Why I think X is overhyped" |85| **Behind the scenes** | "How we built feature Y" |86| **Q&A** | "You asked, we answered" |8788---8990## Writing Developer Emails9192### Subject Line Framework9394What works for developers:9596| Pattern | Example | Why It Works |97|---------|---------|--------------|98| **Specific benefit** | "Cut your build time by 40%" | Concrete value |99| **Technical curiosity** | "The JavaScript feature nobody uses" | Triggers curiosity |100| **Direct announcement** | "v2.0 is here: async/await support" | Clear, newsworthy |101| **Number + topic** | "7 TypeScript tricks senior devs use" | Scannable, specific |102| **Question** | "Are you still using callbacks?" | Pattern interrupt |103| **Breaking news** | "React 19 is out: what you need to know" | Timely, urgent |104105What doesn't work:106107| Avoid | Why |108|-------|-----|109| ALL CAPS | Spam signals |110| "Quick question" | Manipulative |111| Excessive emoji | Looks like marketing |112| "You won't believe..." | Clickbait fatigue |113| No subject line | Just... no |114115### Pre-header Text116117The preview text after the subject line. Use it.118119| Subject | Pre-header |120|---------|------------|121| "v2.0 is here" | "Plus: breaking changes to watch for" |122| "This week in Node.js" | "fetch() drama, npm security, and a cool CLI" |123124### Email Structure125126```127[Short personal intro - 1-2 sentences]128129[Main content sections with clear headers]130131[Code snippet if relevant]132133[Quick links section]134135[Sign-off with personality]136```137138### Code in Email139140Code rendering is tricky in email. Options:141142| Approach | Pros | Cons |143|----------|------|------|144| **Inline code** (`backticks`) | Works everywhere | No highlighting |145| **Plain text block** | Reliable | Ugly |146| **Image of code** | Beautiful | Can't copy, accessibility issues |147| **"View in browser" link** | Full formatting | Friction |148| **Styled HTML tables** | Decent formatting | Complex, can break |149150**Recommendation**: Keep code short. Use inline code for small snippets, link to full examples.151152```html153<pre style="background-color: #1e1e1e; color: #d4d4d4; padding: 16px; border-radius: 4px; font-family: 'Fira Code', monospace; font-size: 14px; overflow-x: auto;">154const result = await fetch('/api/data');155</pre>156```157158---159160## Subject Line Testing161162### A/B Test Framework163164Test one variable at a time:165166| Variable | Version A | Version