newsletter-writer

newsletter-writer is a skill for Claude Code, Codex from ItamarZand88/awesome-agent-conventions. It costs 0 tokens per session (701 once invoked), scanned A, original, MIT.

A writing skill for producing a complete creator newsletter issue from a topic, notes, or source material. A newsletter is a recurring email or publication for an audience; the output includes subject lines, preview text, a hook, body, takeaway, and call to action.

In plain words
What is it for?
Use it to write issues for Substack, beehiiv, ConvertKit, or email, including subject-line options and copy adapted to the writer’s voice.
Why use it?
It turns an incomplete brief into a structured, sendable issue while keeping one clear idea and an obvious next step. It also separates newsletters from business email sequences written for sales or customer follow-up.

Skill for Claude CodeCodex

Written for no agent in particular: nothing here depends on one.

Good fit Use it to write issues for Substack, beehiiv, ConvertKit, or email, including subject-line options and copy adapted to the writer’s voice.

Compare 6 skills from other repositories ↓
Install with agentmods
npx agentmods add skills/itamarzand88/awesome-agent-conventions/newsletter-writer
Install

Getting it into your agent

One page per mod, every tool's command on it. A separate URL per tool would split the same page into five that compete with each other.

Any agent
npx skills add ItamarZand88/awesome-agent-conventions --skill newsletter-writer
Clone the repo
git clone --depth 1 https://github.com/ItamarZand88/awesome-agent-conventions

Made for: Claude Code, Codex.

Wrote this? Show the measurements

A badge with what this costs and how it scanned, read live from this page, so it follows the numbers instead of freezing them. Markdown for a README, HTML for a documentation site or a project page.

agentmods badge for newsletter-writer

README.md
[![agentmods](https://agentmods.dev/badge/skills/itamarzand88/awesome-agent-conventions/newsletter-writer/github.svg)](https://agentmods.dev/skills/itamarzand88/awesome-agent-conventions/newsletter-writer)
Your own site
<a href="https://agentmods.dev/skills/itamarzand88/awesome-agent-conventions/newsletter-writer"><img src="https://agentmods.dev/badge/skills/itamarzand88/awesome-agent-conventions/newsletter-writer/github.svg" alt="Measured on agentmods" height="20"></a>

Or the 80×15 button, for a site that already has a row of RSS and ATOM ones. Only the verdict fits; the numbers stay here.

agentmods 80×15 button for newsletter-writer

Your own site · 80×15
<a href="https://agentmods.dev/skills/itamarzand88/awesome-agent-conventions/newsletter-writer"><img src="https://agentmods.dev/badge/skills/itamarzand88/awesome-agent-conventions/newsletter-writer.svg" alt="Reviewed on agentmods" width="80" height="20"></a>
Per session 0 Skills are progressive disclosure: only the name and description are preloaded; the body loads when the skill is used.
When invoked 701 The whole file, excluding the scripts and references it only reads on demand.
Security scan A 0 findings. A grade says what 26 rules found in the file — not that it is safe.
Origin original No closer match found in the catalogue.
Token cost

What it costs to keep this loaded

Counted locally with the o200k_base tokenizer, which is exact for GPT models; Claude uses its own tokenizer and its counts differ. Treat this as one consistent yardstick across the catalogue rather than a bill. Prices are per million input tokens.

ModelPer sessionOnce invoked
Fable 5.1 $0.00000 $0.00701
Opus 5 $0.00000 $0.00351
Sonnet 5 $0.00000 $0.00140
Haiku 4.5 $0.00000 $0.00070

Measured 13d ago against content hash 5493c754685e, method: parsed. Prices are Anthropic first-party input rates as of 2026-09-12, from the pricing page.

Security

Grade A, and why

newsletter-writer scanned grade A with 0 findings against 26 rules in 11 categories — prompt injection, anti-refusal, data exfiltration, privilege escalation, supply chain, agent snooping, system-prompt leakage, SSRF and excessive agency — measured 13d ago.

A static scan of the body, not an audit. Every finding is printed with the line that produced it so you can judge whether it matters here. A mod is markdown that instructs an agent; that is exactly why what it instructs is worth reading.

Nothing flagged

None of the 26 patterns this scan looks for appear in this file: no shell pipes, no recursive deletes, no credential paths, no hidden text, no instruction-override or anti-refusal phrasing, no agent-config snooping. That is not a guarantee, it is the absence of the things that are checkable.

conventions/skill-md/examples/content-comms/newsletter-writer/SKILL.md · 55 lines

How it starts

The opening of the file, as written. The whole thing — 55 lines — stays where its author put it; the contents beside it link to each section on GitHub.


name: newsletter-writer description: "Write a full creator newsletter issue — subject line, preview text, hook, body with a clear takeaway, and a CTA — in the writer's voice, for Substack, beehiiv, ConvertKit, or email. Use when asked to write a newsletter, an email issue, a Substack post, or to turn notes/a topic into a sendable newsletter. Produces a ready-to-send issue with subject-line options and a skimmable structure. Distinct from B2B drip/nurture sequences."

Newsletter Writer Skill

A newsletter is a relationship, not a broadcast. The best issues open a loop in the subject line, reward the open in the first sentence, deliver one clear idea, and make the next step obvious. This skill writes that issue — in your voice, ready to send.

Working from a brief

Given a topic, notes, or a piece to adapt, write the full issue anyway. Infer the audience and the single idea; mark invented specifics (assumed — replace). Don't hedge with "in this issue we'll explore…" — get to the value.

Required Inputs

Ask for (if not already provided):

  • Topic / notes / source for the issue
  • Audience and voice (or pull from a [[creator-brand-kit]])
  • Goal / CTA (reply, click, subscribe-upgrade, share) and rough length
  • Platform (Substack / beehiiv / ConvertKit / plain email) for formatting norms

Output Format

Subject lines

5 options, mixing curiosity, specificity, and benefit — each ≤ ~50 characters. Star the recommended one.

Preview text

One line (~80 chars) that complements (doesn't repeat) the subject.

The issue

  • Hook — first 1–2 sentences that reward the open and set up the idea.
  • Body — one core idea, in short scannable paragraphs/sub-headers, with a concrete example or story. No throat-clearing.
  • The takeaway — the one thing to remember, stated plainly (a callout line works well).
  • CTA — a single clear next step matching the goal.
  • PS — optional, often the most-read line; use it for a secondary nudge or personal note.

Read the full file on GitHub · 55 lines

Changes

What this file has done since we first saw it

Hashed on every crawl. A supply-chain change to an agent config is a question of when, not whether, so the history is kept rather than the latest state alone.

  1. 13d ago First seen · 55 lines · 0 tokens per session scan A 5493c754685e

Subscribe to this mod's changes

newsletter-writer is a skill published in the GitHub repository ItamarZand88/awesome-agent-conventions (31 stars, last pushed 1mo ago), licensed MIT. It costs nothing until one of its globs matches a file; then it loads 701 tokens. A static security scan graded it A with 0 findings. No closer match exists in the catalogue, so it is treated as the original; first seen 2026-08-30.

Related

Other skills, from other repositories

image-mosaic

Tiled image mosaic, photo mosaic, image mosaic, collage wallpaper, image grid background, and mozaic asset pipeline from approved real source imagery.

marcusquinn/aidevops · 33 tokens

ai-ml-development

AI and machine learning development with PyTorch, TensorFlow, and LLM integration. Use when building ML models, training pipelines, fine-tuning LLMs, or implementing AI features.

travisjneuman/.claude · 43 tokens

case-interview-practice

Interactive consulting case interview practice with structured frameworks, feedback mechanisms, and progressive difficulty. Use when preparing for management consulting interviews, case competitions, or business problem-solving exercises.

travisjneuman/.claude · 39 tokens

i18n-localization

Internationalization and localization for global applications. Use when adding multi-language support, handling regional formats, or preparing apps for global markets.

travisjneuman/.claude · 32 tokens

electron-desktop

Desktop application development with Electron for Windows, macOS, and Linux. Use when building cross-platform desktop apps, implementing native OS features, or packaging web apps for desktop.

travisjneuman/.claude · 38 tokens

finance

Financial analysis expertise for financial modeling (DCF, LBO, M&A), valuation, financial statement analysis, capital allocation, treasury management, and corporate finance decisions. Use when building financial models, analyzing statements, or making investment decisions.

travisjneuman/.claude · 48 tokens