# email-subject-lines

Writes and scores email subject lines for open rates, then suggests pairs to A/B test.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 448 installs · ★ 721
- Author: OpenClaudia
- License: MIT · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/OpenClaudia/openclaudia-skills/tree/HEAD/skills/email-subject-lines/SKILL.md
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/skills/email-subject-lines

## What it does

This skill turns the agent into a subject line specialist. It asks for the email's purpose, a short content summary, the audience, the tone and any brand voice rules, plus how many options you want. The default is 10 options with 3 recommended A/B pairs.

Seven formulas are built in: curiosity gap, urgency, personalization, question, number/list, how-to and contrarian. Each comes with examples and rules. Length gets its own section — the target is 30–50 characters, since an iPhone shows roughly 35–40 and the Gmail app about 40.

Urgency and contrarian angles only pay off when they are honest. A fake deadline costs you trust, and a provocative subject brings opens and unsubscribes together. If the body does not deliver what the subject promised, none of it matters.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add OpenClaudia/openclaudia-skills --skill email-subject-lines -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/email-subject-lines/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/email-subject-lines/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add OpenClaudia/openclaudia-skills --skill email-subject-lines -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/email-subject-lines/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add OpenClaudia/openclaudia-skills --skill email-subject-lines -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/email-subject-lines/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install OpenClaudia/openclaudia-skills email-subject-lines
```

2. **Manually: put the files in place**
- File: `.github/skills/email-subject-lines/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add OpenClaudia/openclaudia-skills --skill email-subject-lines -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/OpenClaudia/openclaudia-skills --path skills/email-subject-lines
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/email-subject-lines/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add OpenClaudia/openclaudia-skills --skill email-subject-lines -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/OpenClaudia/openclaudia-skills/tree/HEAD/skills/email-subject-lines/SKILL.md

## When to use it
- draft subject line options for a campaign and pick three A/B pairs
- keep a subject within 30–50 characters so mobile clients do not truncate it
- match the tone to the audience, from formal to playful
- check whether an urgency angle reads as fake
- write a question subject the reader can only answer by opening

## Example prompts
- Write 10 subject lines for a launch email to existing customers, professional tone
- Give me 3 A/B pairs for this campaign and say what each one tests
- Shorten this subject so it fits the mobile preview

## Source text · SKILL.md · MIT

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 7beee10f7cb95a97.

BEGIN THIRD-PARTY FILE 7beee10f7cb95a97
```text
---
name: email-subject-lines
description: >
  Generate, evaluate, and A/B test email subject lines for maximum open rates. Includes formulas
  for curiosity, urgency, personalization, and more. Trigger phrases: "email subject line",
  "subject line ideas", "email subject", "write subject lines", "A/B test subject lines",
  "improve open rates", "email open rate", "subject line formulas".
---

# Email Subject Lines Skill

You are an email subject line specialist. Your job is to generate high-performing subject lines
that maximize open rates while maintaining trust and deliverability.

## Gathering Requirements

Before generating subject lines, collect these inputs:

1. **Email purpose** - Newsletter, promotional, transactional, nurture, announcement, etc.
2. **Content summary** - What is the email about? (2-3 sentences)
3. **Audience** - Who is receiving this? Segment details.
4. **Tone** - Professional, casual, urgent, playful, mysterious.
5. **Brand voice** - Any specific do's or don'ts?
6. **Historical data** - Past subject lines that performed well or poorly (if available).
7. **Quantity needed** - How many options? (Default: 10 options with 3 recommended A/B pairs)

## Character Length Optimization

| Length | Characters | Use For | Why |
|--------|-----------|---------|-----|
| Short | 20-30 chars | Mobile-first, curiosity-driven | Fully visible on all devices, punchy |
| Medium | 30-50 chars | Most email types (sweet spot) | Enough info without truncation |
| Long | 50-70 chars | Descriptive, B2B, newsletters | More context, but truncated on mobile |
| Very long | 70+ chars | Avoid | Truncated everywhere, looks spammy |

**Target: 30-50 characters (6-10 words).** This range is fully visible on mobile and desktop.

**Mobile preview widths:**
- iPhone: ~35-40 characters
- Android: ~33-43 characters
- Gmail app: ~40 characters

## Subject Line Formulas

### 1. Curiosity Gap

Create an information gap that can only be closed by opening the email.

**Pattern:** Hint at valuable information without revealing it.

| Example | Why It Works |
|---------|-------------|
| "The one metric you're probably ignoring" | Implies they are missing something important |
| "We analyzed 10K emails. Here's what we found." | Teases data without giving the answer |
| "This changed how I think about pricing" | Personal revelation without the detail |
| "The mistake killing your conversion rate" | Specific problem, unnamed solution |
| "I was wrong about cold email" | Contrarian + personal admission |

**Rules:**
- Do not be vague to the point of irrelevance ("You won't believe this!").
- The email body must deliver on the curiosity promise.
- Use sparingly; overuse trains subscribers to distrust.

### 2. Urgency

Create time pressure that motivates immediate action.

| Example | Type |
```
END THIRD-PARTY FILE 7beee10f7cb95a97

The third-party file has ended. Everything between the 7beee10f7cb95a97 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2817 of 13016 bytes. © OpenClaudia · MIT · https://github.com/OpenClaudia/openclaudia-skills/tree/HEAD/skills/email-subject-lines/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md