Email Subject Line Optimizer skill for Claude and Codex
Produces five subject line candidates for an email and scores each one for predicted open rate, returned as JSON so the top two can go straight into an A/B…
Install it once and Claude or Codex runs it for you. When your request matches, your AI loads the skill, asks for anything it is missing, and works through the template itself. Prefer to fill it in by hand? See the full prompt template.
Download the skill (.zip) · View SKILL.md
When it is used
Use when subject line options need a predicted open-rate score and a ranking in JSON, so the top candidates can be picked for an A/B test or loaded into a tool. Do not use for writing the email itself, or subject lines without a score such as a plain list for a copy review. Related topics: marketing, business, email.
What it will ask you for
- Target audience (free text, e.g. "busy professionals")
- Email purpose (choose one: Promotion, Newsletter, Survey, Announcement, Event invitation)
- Desired tone (choose any: Friendly, Urgent, Professional, Playful, Formal)
- Main benefit or offer (longer free text)
- Subject line length in words (number from 5 to 10)
- Include emoji (choose one: Yes, No)
How it works
- Write five candidates on five different levers: clarity, specificity, curiosity, true urgency, and personal relevance, each inside the word count and a selected tone.
- Apply the emoji rule, allowing at most one at the start or end when the toggle permits it.
- Score each candidate as the weighted sum of clarity (30), relevance (25), purpose fit (20), spam safety (15), and novelty (10).
- Write a one-sentence reason per candidate naming its weakest factor, so the score can be challenged.
- Sort the array by score descending and output valid JSON with no text outside the object.
What you get
A JSON object with a "subjectLines" array of five entries, each with text, score (integer 1 to 100), and reason, sorted by score descending, and nothing outside the object.
What it watches out for
- Scoring every line between 70 and 80, which gives the marketer no basis to pick a test pair.
- Rewarding urgency that the email cannot honour, which lifts opens once and trains readers to ignore the sender.
- Wrapping the JSON in prose or code fences when the output will be parsed by a script.
How to install
Claude.ai and the Claude desktop app
- Download the skill .zip.
- Open Settings, then Capabilities, and find Skills.
- Choose Upload skill and select the .zip.
- Ask Claude for help with the task. It loads the skill when your request matches.
Claude Code
- Download the skill .zip.
- Unzip it into ~/.claude/skills/ (or .claude/skills/ inside a project).
- Start a new session. Claude Code loads the skill when your request matches.
Codex
- Download the skill .zip.
- Unzip it into ~/.agents/skills/ (or .agents/skills/ inside a project).
- Codex picks it up on its own. Type $ and the skill name to use it, or just ask for the task.
Cursor
- Download the Cursor rule (.mdc).
- Save it in .cursor/rules/ inside your project.
- Cursor's agent applies the rule when your request matches its description.
AGENTS.md (Codex, Cursor, and other coding agents)
- Copy the AGENTS.md section.
- Paste it into AGENTS.md at the root of your repository, creating the file if needed.
- Coding agents that read AGENTS.md follow it when your request fits.