Agent skill

Newsletter

by ericrisco in ericrisco/rsc-harness

A skill your agent uses when running an email newsletter as a recurring publication — subject + preview pair, issues that turn opens into clicks, the welcome sequence, cadence and engagement…

MITAuto-check passedWriting & Content

Install Newsletter

skills CLI
$ npx skills add ericrisco/rsc-harness --skill newsletter -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install ericrisco/rsc-harness newsletter --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/ericrisco/rsc-harness.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/newsletter .claude/skills/newsletter && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
newsletter
GitHub stars
180
Token cost
~2.9k tokens
SKILL.md length
1,446 words
Files
6 (incl. scripts, references)
Skills in repo
233
Repo updated
First seen
Licence
MIT

At a glance

A skill your agent uses when running an email newsletter as a recurring publication — subject + preview pair, issues that turn opens into clicks, the welcome sequence, cadence and engagement…

  • Works in 3 steps: Deliver the promise (immediate) — the… → Set expectations + best-of (day 1–2) —… → The referral ask (day 4–5) — once…
  • Running an email newsletter as a recurring publication — subject + preview pair
  • SKILL.md covers When NOT to use — route instead, The metric truth after Apple MPP, Issue anatomy — one job per… and Subject + preview as a pair, plus 7 more sections
  • Runs Shell scripts from its folder

What it does

Newsletter is an agent skill from ericrisco/rsc-harness. Use when running an email newsletter as a recurring publication — subject + preview pair, issues that turn opens into clicks, the welcome sequence, cadence and engagement tiering, growth loops, and a post-Apple-MPP click scorecard. NOT one-off launch or nurture sends (that is marketing), NOT SPF/DKIM/DMARC (that is email-deliverability).

Its SKILL.md is about 2.9k tokens, which your agent loads only when the skill is triggered. The skill folder holds 8 other files, including scripts and reference files (for example `evals/README.md`, `evals/cases.yaml` and `references/growth-loops.md`).

It sits in Writing & Content, covering Newsletters, Email marketing and Go-to-market strategy. The repository describes itself as: Your agent invents things because it has no memory, and can't touch your database because it has no arms. rsc is the meta-harness that gives it both, plus the trade to know the… The licence is MIT.

When your agent uses it

  • Running an email newsletter as a recurring publication — subject + preview pair
  • Issues that turn opens into clicks
  • The welcome sequence
  • Cadence and engagement tiering

Example prompts

  • “/newsletter”

Requirements

  • A Bash shell

Workflow steps

3 steps, taken from the first numbered list in SKILL.md.

  1. Deliver the promise (immediate) — the thing they signed up for, instantly. Sets the expectation that you ship value.
  2. Set expectations + best-of (day 1–2) — what arrives, how often, plus your best past issue so they see the ceiling.
  3. The referral ask (day 4–5) — once they've gotten value, ask them to share (the theSkimm pattern: referral ask inside the welcome, not…

What it can do on your machine

Read from SKILL.md and the folder at commit 1f8d9bb. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    Ships 1 file in scripts/ (Shell), which the agent can run.

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Newsletter loads about 2.9k tokens when it runs, and up to ~4.5k if it reads all its reference files. Until then it costs about 89 tokens; SKILL.md has 1,446 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~89
When it runs · the whole SKILL.md, loaded when a task matches
~2.9k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~4.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); the scripts in this folder are not scanned.

SKILL.md

The full file from ericrisco/rsc-harness at commit 1f8d9bb, republished under its MIT licence (© ericrisco). 1,446 words, ~2,873 tokens.

Download SKILL.mdSave it as .claude/skills/newsletter/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.
name
newsletter
description
Use when running an email newsletter as a recurring publication — subject + preview pair, issues that turn opens into clicks, the welcome sequence, cadence and engagement tiering, growth loops, and a post-Apple-MPP click scorecard. NOT one-off launch or nurture sends (that is `marketing`), NOT SPF/DKIM/DMARC (that is `email-deliverability`).
tags
newsletter, email, growth, copywriting, retention-metrics
recommends
marketing, email-deliverability, brand-voice, landing-copy, ab-testing
origin
risco

newsletter

Run the newsletter as a product you ship on a cadence, not a one-off send. The job is the system around the recurring issue: the subject + preview that earns the open, the issue body that earns the click, the welcome sequence that activates a new subscriber, the cadence and segmentation that keep the list healthy, the growth loops that compound it, and a scorecard that still tells the truth after Apple broke open rates. Every send is one episode of an ongoing show — design the show, not the episode.

When NOT to use — route instead

The askRoute to
One-off product launch announcement or campaign drip nurture../marketing/SKILL.md
Mail lands in spam; set up SPF / DKIM / DMARC, tracking domain, reputation../email-deliverability/SKILL.md
Write the subscribe / opt-in landing page copy../landing-copy/SKILL.md
Define the house voice, tone, and vocabulary the newsletter speaks in../brand-voice/SKILL.md
Win back / reactivate lapsed paying customers (lifecycle, not readers)../retention/SKILL.md
Produce the underlying long-form articles the issue links out to../content-engine/SKILL.md
Sample size / significance / MDE math for the test itself../ab-testing/SKILL.md
Source or scrape new contacts; prospect an un-opted-in list../lead-gen/SKILL.md, ../cold-outreach/SKILL.md
Actually wire the send through an ESP / Gmail API and schedule it../email-connector/SKILL.md, ../google-workspace/SKILL.md

You own the recurring opted-in publication and its open/click/growth system. The plumbing under every send and the page that captures the signup are someone else's.

The metric truth after Apple MPP

Apple Mail Privacy Protection pre-fetches the tracking pixel, firing an "open" even when nobody read the email. It accounts for ~49% of all tracked opens and inflates reported open rate by ~15–35% on iOS-heavy lists — one beehiiv newsletter jumped from a 28% to a 55% open rate with zero behavior change. So stop steering on open rate. MPP does not touch link tracking, which is why the click is now the honest signal.

Rule: make click rate and non-Apple CTOR the north star, because the click is the one event MPP cannot fake. Leading 2025 programs removed open rate from decision-making entirely and anchor on clicks.

Calibration benchmarks (2025, cross-industry): average open rate ~42–43% (MPP-inflated, treat as noise), average click rate ~2.1% (range 0.83%–4.90%), click-to-open ~6.8%, conversion ~0.08% (top decile ~0.44%). Use the click figures to calibrate; ignore the open figure as a target.

The scorecard — track these, in this order:

MetricWhat it tells youTrust
Net engaged readers (clicked in last N issues)The list that actually existsHigh — steer on this
Click rate (unique clicks / delivered)Did the issue earn actionHigh
CTOR on the non-Apple segmentDid the body convert the openHigh
Unsubscribe rateCadence / relevance painMedium
Spam-complaint rateInbox placement risk (gate, not vanity)High — keep < 0.1%
Open rateAlmost nothing post-MPPLow — do not target

Issue anatomy — one job per issue

Each issue gets exactly one job and exactly one primary CTA. A second CTA halves the first. Put the hook on the first screen (subject's promise paid off before any scroll), keep the body scannable (short paragraphs, one idea per block, links that read as links), and end at a single button-grade action.

text
Bad (rambling, no single job, CTA buried):
  Hey everyone! Lots going on this week — we shipped some updates, there's a
  webinar coming, I read a great book, and oh also our pricing changed, plus
  here are five links I liked. Anyway, check it all out when you get a chance!

Good (one promise, one payoff, one CTA):
  This week: the 3-line config change that cut our cold-start by 40%.
  • What it was   • Why the default is wrong   • The exact diff
  → Read the 4-minute breakdown   [single primary link]

Everything secondary becomes a one-line P.S. or a small "also" block, never a competing button.

Subject + preview as a pair

The subject and the preview (preheader) ship together and are tested together — they share the inbox row.

  • Payload in the first ~33 characters; keep the whole subject ~30–50 chars (≈7–9 words) so it survives mobile truncation.
  • The preview extends the subject, it never repeats it. Its first ~35–50 chars are prime real estate; waste them on a duplicate and you've burned the line.
  • ≤2 emojis, at the end, never an all-emoji subject — an all-emoji subject is the one case that actually trips filters.
  • The "spam trigger words" list is a myth. "Free", "guarantee", a normal emoji — these do not sink you; authentication and sender reputation dominate deliverability. Police reputation, not vocabulary; the reputation/auth layer lives in ../email-deliverability/SKILL.md.
text
Bad (payload past char 33, preview repeats subject):
  Subject:  We are very excited to finally share our big new feature today!!!
  Preview:  We are very excited to share our big new feature

Good (payload first, preview extends):
  Subject:  Cut cold-start 40% with 3 lines
  Preview:  The default config is wrong — here's the exact diff and why

Cadence & segmentation

Cadence is not one number for the whole list — it branches on how engaged the reader is. This is the decision table:

Engagement tierSignalFrequencyTrack
HeavyClicked most recent 2–3 issuesFull / can increasePrimary issue + occasional bonus
ActiveOpened-and-clicked within ~30 daysFullPrimary issue
CoolingNo click in ~30–60 daysReduceBest-of / slower nurture
DormantNo click in ~90+ daysPauseRe-permission ("still want this?") then sunset

Sunset dormant addresses on purpose — complaint rate, not list size, gates the inbox. Mailing a decaying list harder is how a sender torches its reputation.

Send-time default: Tuesday/Thursday mid-morning (~10am) or early afternoon (1–3pm) is the cross-industry baseline — but treat it as a hypothesis to test against your own list's click data, not a law. Segmented sends earn roughly 100% higher click rates than blast-to-everyone, so segment before you optimize send time. Tier definitions and the full sunset/re-permission flow live in references/growth-loops.md.

The welcome sequence

A confirmed subscriber gets a 3–5 email sequence, not silence until the next issue — this window is the highest engagement they'll ever have. One job per email:

  1. Deliver the promise (immediate) — the thing they signed up for, instantly. Sets the expectation that you ship value.
  2. Set expectations + best-of (day 1–2) — what arrives, how often, plus your best past issue so they see the ceiling.
  3. The referral ask (day 4–5) — once they've gotten value, ask them to share (the theSkimm pattern: referral ask inside the welcome, not bolted on later). 4–5. Optional: segmentation/preference capture and a feedback prompt.

Full skeleton with timing, subject+preview per email, and the one-job rule: references/welcome-sequence.md.

Show full SKILL.md (528 more words)Show less

Growth loops

Three loops compound the list; depth and the dated numbers are in references/growth-loops.md.

  • Referral — referral programs lift subscriber growth ~17% on average and can accelerate growth 20–200% (The Hustle's referral drives ~10%+ of its free-list growth). Put the ask inside the welcome sequence and at the issue footer, gated on tiered rewards.
  • Signup incentive / lead magnet — a specific, immediately useful asset converts the subscribe far better than "join our newsletter". The asset is what gets shared.
  • Double opt-in — confirm the address before it joins. It protects list quality and keeps the complaint rate down, which is what actually keeps you in the inbox. The subscribe page itself is ../landing-copy/SKILL.md.

Compliance baseline

A newsletter is the canonical bulk marketing message, so the Gmail/Yahoo bulk-sender rules (enforced since Nov 2025 for 5,000+/day senders) apply to every issue:

  • RFC 8058 one-click unsubscribe (List-Unsubscribe + List-Unsubscribe-Post headers) on every send, plus a visible footer unsubscribe link. Both, always.
  • Keep the spam-complaint rate under 0.1% and never let it reach 0.3%. This is why you sunset, not why you mail harder.

The DNS / authentication side of those rules — SPF, DKIM, DMARC, the sending domain — is not this skill; that is ../email-deliverability/SKILL.md. This skill applies the rules to the issue and the cadence.

A/B testing the right way

  • Test exactly one element at a time — subject vs subject, or preview vs preview. Change two and the winner is uninterpretable.
  • Put preview text in the rotation, not just the subject; it's half the inbox row and usually under-tested.
  • The statistical design — sample size, significance, minimum detectable effect — is ../ab-testing/SKILL.md. This skill tells you what to test; that one tells you whether the result is real.

Anti-patterns

PatternWhy it failsFix
Steering on open rate post-MPP~49% of opens are bot-fired; the number is fictionSteer on click rate + non-Apple CTOR
Two or more primary CTAs in one issueThey split attention; the main action losesOne job, one button per issue
Preview text repeats the subjectBurns half the inbox row on a duplicatePreview extends the subject with new info
Mailing a decaying list harderComplaints climb; reputation and inbox placement collapseSunset / re-permission the dormant tier
All-emoji subject lineThe one emoji case that actually trips filters≤2 emojis, at the end, around real words
Policing "spam trigger words"A myth; reputation/auth decide deliverabilityFix auth + reputation in ../email-deliverability/SKILL.md
Buying a list / no double opt-inSpam traps and complaints gate the whole senderDouble opt-in; grow with referral + lead magnet
Testing two variables at onceWinner is uninterpretableOne variable; preview in the rotation
Referral ask bolted on months laterMisses peak engagementPut the ask inside the welcome sequence
Same cadence for the whole listHeavy readers under-served, dormant ones complainTier the cadence by engagement

Verify

scripts/verify.sh is a read-only structural linter for a drafted issue file (subject: / preview: lines, body, footer). It checks subject length and payload position, that the preview exists and differs from the subject, emoji count, a single primary-CTA marker, and a present unsubscribe line. Run it on the draft before you ship — it never edits the file and exits 0 on an empty one.

© ericrisco, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

SKILL.md and 5 other files (scripts, references) in skills/newsletter of ericrisco/rsc-harness.

  • SKILL.md
  • evals/README.md
  • evals/cases.yaml
  • references/growth-loops.md
  • references/welcome-sequence.md
  • scripts/verify.sh

Open the folder on GitHubat commit 1f8d9bb

Compare with similar skills

Newsletter next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Newsletter compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Newsletter this skillericrisco/rsc-harness180—~2.9kAutomated safety check: PassMIT
Form Emailjeremylongshore/tons-of-skills-marketplace2.8k—~3.6kAutomated safety check: NotesMIT
Email Marketingkostja94/marketing-skills1k—~1.5kAutomated safety check: PassMIT
Building Communication EngineGTM-Strategist/gtm-strategist-skills264—~2.8kAutomated safety check: PassMIT
Email Marketingsanqiufong/slides-from-anything1321 repos~861Automated safety check: PassApache-2.0
Email Marketingarnabbagxd/Brand-building-skills729—~2.5kAutomated safety check: PassMIT

Similar skills

  • Form Email

    jeremylongshore/tons-of-skills-marketplace

    A skill your agent uses when asked to design an email template, newsletter, drip campaign email, transactional email, or any HTML email asset.

    2.8k GitHub stars~3.6k tokensUpdated today
    Marketing & SEOAuto-check: notes
  • Email Marketing

    kostja94/marketing-skills

    When the user wants to plan email marketing, EDM, newsletter strategy, or email deliverability.

    1k GitHub stars~1.5k tokensUpdated 4 days ago
    Marketing & SEOAuto-check passed
  • Building Communication Engine

    GTM-Strategist/gtm-strategist-skills

    A skill your agent uses when the user wants to choose marketing channels, plan their launch newsletter, set a GTM budget, collect social proof, or build their communication strategy.

    264 GitHub stars~2.8k tokensUpdated 2 mo ago
    Writing & ContentAuto-check passed
  • Email Marketing

    sanqiufong/slides-from-anything

    A brand product-launch email — masthead with wordmark, hero image block, headline lockup with skewed-italic accent, body copy, primary CTA, and a specifications grid.

    132 GitHub starsUsed in 1 repo~861 tokens
    Marketing & SEOAuto-check passed
  • Email Marketing

    arnabbagxd/Brand-building-skills

    Build and run a full email marketing channel — list building, deliverability, segmentation, newsletter strategy, campaign types, A/B testing, and email design.

    729 GitHub stars~2.5k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check passed
  • 49 HTML Email Template Global

    minhnv0807/ai-business-skills

    A skill your agent uses when responsive HTML email has to render correctly in every client — table-based structure, inline CSS, 600px max width, dark mode handling, quirks for Gmail, Apple Mail…

    609 GitHub stars~2.6k tokensUpdated 28 days ago
    Frontend & DesignAuto-check passed

More from ericrisco/rsc-harness

All 233 skills in this repo
  • Ab Testing

    ericrisco/rsc-harness

    A skill your agent uses when designing or analyzing a controlled experiment — falsifiable hypothesis, sample size from an MDE, reading significance/CI/power, CUPED, or rescuing tests that won't go…

    180 GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Accessibility

    ericrisco/rsc-harness

    A skill your agent uses when making a web UI conform to WCAG 2.2 Level AA — axe-core or Lighthouse a11y violations, keyboard operability, focus management, ARIA roles/names/live regions, contrast…

    180 GitHub stars~3.4k tokensUpdated today
    Auto-check passed
  • Ads

    ericrisco/rsc-harness

    A skill your agent uses when running or fixing paid acquisition on Google or Meta — campaign structure (Performance Max, Demand Gen, Search, Advantage+), platform-fit creative, budget/scaling rules…

    180 GitHub stars~2.2k tokensUpdated today
    Auto-check passed
  • Agent Eval

    ericrisco/rsc-harness

    A skill your agent uses when measuring whether an LLM or agent system actually got better and gating merges on it: golden sets, fixing an inflated LLM-as-judge, scoring RAG (faithfulness, contextual…

    180 GitHub stars~3.2k tokensUpdated today
    Auto-check passed
  • AI Media

    ericrisco/rsc-harness

    A skill your agent uses when a creative goal must become a finished media file: pick and order generative-media models per modality — AI voiceover, image-to-video clips, score — then glue them with…

    180 GitHub stars~3.3k tokensUpdated today
    Auto-check passed
  • Analytics

    ericrisco/rsc-harness

    A skill your agent uses when instrumenting product or web analytics — GA4/PostHog SDK wiring, event taxonomy, funnels, double-counted events, consent gating, PII scrubbing.

    180 GitHub stars~2.8k tokensUpdated today
    Auto-check passed

Questions about Newsletter

What does Newsletter do?

A skill your agent uses when running an email newsletter as a recurring publication — subject + preview pair, issues that turn opens into clicks, the welcome sequence, cadence and engagement…. Newsletter is an agent skill from ericrisco/rsc-harness. Use when running an email newsletter as a recurring publication — subject + preview pair, issues that turn opens into clicks, the welcome sequence, cadence and engagement tiering, growth loops, and a post-Apple-MPP click scorecard.

When should I use Newsletter?

Newsletter fits situations like: running an email newsletter as a recurring publication — subject + preview pair; issues that turn opens into clicks; the welcome sequence; cadence and engagement tiering.

How do I install Newsletter in Claude Code?

Run `npx skills add ericrisco/rsc-harness --skill newsletter -a claude-code`. Or copy the skill folder (skills/newsletter in ericrisco/rsc-harness) into .claude/skills/newsletter in your project. Claude Code loads it when a task matches its description.

How do I install Newsletter in Codex?

Run `npx skills add ericrisco/rsc-harness --skill newsletter -a codex`. Or copy the skill folder (skills/newsletter in ericrisco/rsc-harness) into .agents/skills/newsletter in your project. Codex loads it when a task matches its description.

Can I use Newsletter in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add ericrisco/rsc-harness --skill newsletter -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/newsletter, .gemini/skills/newsletter, .github/skills/newsletter and .opencode/skills/newsletter in your project.

What does Newsletter need to run?

Going by SKILL.md and its folder, Newsletter needs a shell for the scripts in its folder. Our summary lists: A Bash shell.

Does Newsletter access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Newsletter safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. The check reads SKILL.md only: the scripts in the folder are not scanned, so read them before running anything.

What licence does Newsletter use?

Newsletter is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Newsletter use?

About 2.9k tokens (SKILL.md is roughly 11k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.6k tokens, read only when the agent opens those files.

What are the alternatives to Newsletter?

Skills that share tags, products or a category with Newsletter: Form Email (jeremylongshore/tons-of-skills-marketplace, 2.8k stars), Email Marketing (kostja94/marketing-skills, 1k stars), Building Communication Engine (GTM-Strategist/gtm-strategist-skills, 264 stars) and Email Marketing (sanqiufong/slides-from-anything, 132 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Newsletter?

ericrisco (a GitHub user) maintains it in ericrisco/rsc-harness, which has 180 GitHub stars. The repository holds 233 skills in this directory. The repository was last updated on October 9, 2026.

Source: ericrisco/rsc-harness on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.