Agent skill

Newsletter

by OpenClaudia in OpenClaudia/openclaudia-skills

Plan and grow an email newsletter. An agent skill from OpenClaudia/openclaudia-skills.

MITAuto-check passedWriting & Content

Install Newsletter

skills CLI
$ npx skills add OpenClaudia/openclaudia-skills --skill newsletter -a claude-code

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

GitHub CLI
$ gh skill install OpenClaudia/openclaudia-skills 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/OpenClaudia/openclaudia-skills.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
713
Token cost
~2k tokens
SKILL.md length
805 words
Files
1
Skills in repo
74
Repo updated
First seen
Licence
MIT

At a glance

Plan and grow an email newsletter. An agent skill from OpenClaudia/openclaudia-skills.

  • Works in 3 steps: Curated — Links + commentary (e.g.,… → Original — Single essay/article (e.g.,… → Hybrid — Original intro + curated links…
  • The user says newsletter strategy
  • SKILL.md covers Newsletter Fundamentals, Growth Strategies, Engagement & Retention and Monetization, plus 3 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Newsletter is an agent skill from OpenClaudia/openclaudia-skills. Plan and grow an email newsletter. Use when the user says "newsletter strategy", "grow my newsletter", "newsletter content", "email newsletter", "subscriber growth", "newsletter monetization", "Substack strategy", "Beehiiv", or asks about building, growing, or monetizing a newsletter.

Its SKILL.md is about 2k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content, covering Newsletters. It works with Substack. The repository describes itself as: 77 open-source marketing skills for Claude Code, Codex, and other AI coding agents. SEO, content, email, ads, analytics, and growth. The licence is MIT.

When your agent uses it

  • The user says newsletter strategy
  • Grow my newsletter
  • Newsletter content
  • Email newsletter

Example prompts

  • “newsletter strategy”
  • “grow my newsletter”
  • “newsletter content”
  • “/newsletter”

Workflow steps

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

  1. Curated — Links + commentary (e.g., TLDR, Morning Brew)
  2. Original — Single essay/article (e.g., Lenny's Newsletter, Stratechery)
  3. Hybrid — Original intro + curated links (most common)

What it can do on your machine

Read from SKILL.md and the folder at commit 28bf209. 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

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    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 2k tokens when it runs. Until then it costs about 74 tokens; SKILL.md has 805 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~74
When it runs · the whole SKILL.md, loaded when a task matches
~2k

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); files beside SKILL.md are not scanned.

SKILL.md

The full file from OpenClaudia/openclaudia-skills at commit 28bf209, republished under its MIT licence (© OpenClaudia). 805 words, ~2,044 tokens.

Download SKILL.mdSave it as .claude/skills/newsletter/SKILL.md (or your agent's skills folder).
name
newsletter
description
Plan and grow an email newsletter. Use when the user says "newsletter strategy", "grow my newsletter", "newsletter content", "email newsletter", "subscriber growth", "newsletter monetization", "Substack strategy", "Beehiiv", or asks about building, growing, or monetizing a newsletter.

Newsletter Growth Skill

You are a newsletter growth strategist. Help plan content, grow subscribers, improve engagement, and monetize newsletters.

Newsletter Fundamentals

Subject Lines

Formulas that work:

FormulaExampleOpen Rate Impact
Number + Benefit"7 tools that saved me 10hrs/week"High
Question"Are you making this SEO mistake?"High
How-to + Specific"How I grew to 10K subs in 6 months"High
Curiosity gap"The strategy nobody talks about"Medium-High
News/Urgency"Breaking: Google just changed this"Medium
Personal/Story"I almost quit last week"Medium
List/Roundup"This week: 5 links worth your time"Medium

Rules:

  • 30-50 characters optimal (mobile-friendly)
  • Preview text is equally important — extend the subject line, don't repeat it
  • Personalization tokens ({first_name}) lift open rates 5-10%
  • Avoid spam triggers: FREE, URGENT, ALL CAPS, excessive punctuation
  • A/B test subjects on every send
Content Structure

The 3 newsletter archetypes:

  1. Curated — Links + commentary (e.g., TLDR, Morning Brew)

    • 5-10 links with 2-3 sentence commentary each
    • Fastest to produce, requires good sources
    • Best for: News, industry updates, trends
  2. Original — Single essay/article (e.g., Lenny's Newsletter, Stratechery)

    • 1,000-2,500 words of original analysis
    • Highest authority building, most effort
    • Best for: Thought leadership, premium/paid
  3. Hybrid — Original intro + curated links (most common)

    • 200-500 word original section + 3-5 curated links
    • Good balance of effort and value
    • Best for: Most newsletters starting out
Frequency
FrequencyProsConsBest For
DailyHabit-forming, high touchBurnout risk, high churnNews, curated
2-3x/weekGood balanceModerate effortCurated, hybrid
WeeklyMost sustainableSlower growthOriginal, hybrid
BiweeklyLow effortEasy to forgetPremium, long-form
MonthlyMinimal timeLow engagementCompany updates

Recommendation: Start weekly. Only increase frequency when you have a system (templates, curation tools, or a team).

Growth Strategies

Tier 1: Foundation (0 → 1,000 subscribers)
  1. Lead magnet — Offer a free resource in exchange for email

    • Checklist, template, cheat sheet, toolkit, mini-course
    • Must be instantly valuable (no "coming soon")
    • Place on: landing page, blog sidebar, exit intent popup
  2. Landing page optimization

    • Clear value proposition above the fold
    • Social proof (subscriber count, testimonials, "as featured in")
    • Show a sample issue
    • Single CTA, no distractions
  3. Content-driven signup

    • Add newsletter CTA to every blog post
    • Create content upgrades (bonus content in exchange for email)
    • Embed signup forms in content, not just sidebar
  4. Personal network — Email contacts, social media announcement, community posts

Tier 2: Growth (1,000 → 10,000)
  1. Referral program

    • Reward subscribers who refer others
    • Milestone rewards: 1 referral = bonus content, 5 = exclusive access, 10 = merchandise/call
    • Tools: SparkLoop, ReferralHero, or built-in (Beehiiv, ConvertKit)
  2. Cross-promotions

    • Partner with complementary newsletters (similar audience, not competing)
    • Swap recommendations: "If you enjoy this, you'll also love {partner newsletter}"
    • Paid cross-promotion: $1-5 per subscriber
  3. Social media funnel

    • Post newsletter excerpts on Twitter/LinkedIn with "Subscribe for more"
    • Carousel previews of newsletter content on Instagram
    • Turn newsletter insights into Twitter threads
  4. SEO-driven landing pages

    • Create keyword-targeted pages that lead to newsletter signup
    • "Best {topic} newsletters" comparison pages
    • Archive past issues as searchable blog posts
Show full SKILL.md (319 more words)Show less
Tier 3: Scale (10,000+)
  1. Paid acquisition — Facebook/Instagram ads to landing page, $1-5 CPA target
  2. Podcast/video guest appearances — Mention newsletter as CTA
  3. Giveaways — Viral giveaway campaigns (use KingSumo, Gleam)
  4. Acquisitions — Buy smaller newsletters in your niche

Engagement & Retention

Key Metrics
MetricGoodGreatAction if Below
Open rate35-45%50%+Improve subjects, clean list
Click rate3-5%7%+Better CTAs, more relevant links
Unsubscribe rate<0.5%<0.2%Segment, reduce frequency
Reply rate1-2%3%+Ask questions, be personal
Growth rate5-10%/mo15%+/moDouble down on top acquisition channel
Re-engagement Campaign

For subscribers who haven't opened in 60+ days:

Email 1 (Day 0): "Still interested in {topic}? Here's what you missed"
  → Share 3 best recent issues

Email 2 (Day 7): "Should I remove you?"
  → Direct ask: click to stay, or we'll unsubscribe you

Email 3 (Day 14): "Last chance — we're cleaning our list"
  → Final warning, then remove non-openers
Welcome Sequence
Email 1 (Immediate): Welcome + lead magnet delivery + "what to expect"
Email 2 (Day 2): Your story + best issue ever (showcase value)
Email 3 (Day 5): "Reply and tell me..." (build relationship)
Email 4 (Day 7): Social proof + referral ask

Monetization

ModelWhen to StartRevenue Potential
Sponsorships1,000+ subscribers$25-50 CPM
Paid subscriptions5,000+ free subscribers$5-20/month
Affiliate linksAny size5-15% of clicks convert
Digital products2,000+ subscribers$10-500 per product
Consulting/servicesAny sizeVaries
Courses5,000+ subscribers$50-500 per student
Sponsorship Rate Card
CPM = (Sponsorship price / Subscribers) × 1,000

Industry averages:
- General/consumer: $15-25 CPM
- Business/marketing: $25-50 CPM
- Developer/technical: $30-60 CPM
- Finance/investing: $40-80 CPM
- Executive/C-suite: $50-100 CPM

Deliverability

Must-Have Technical Setup
CheckWhy
SPF recordProves you're authorized to send from your domain
DKIM signingCryptographic signature preventing spoofing
DMARC policyTells receivers what to do with failed auth
Custom sending domainAvoid shared IP reputation issues
Sunset inactive subscribersRemove non-openers after 90 days
Avoid Spam Filters
  • Maintain text-to-image ratio (80% text, 20% images)
  • Include unsubscribe link (required by law)
  • Use a real reply-to address
  • Don't use URL shorteners (bit.ly triggers spam filters)
  • Warm up new sending domains gradually

Output Format

When creating a newsletter strategy, deliver:

markdown
# Newsletter Strategy: {Newsletter Name}

## Concept
- **Niche:** {topic/audience}
- **Format:** {curated/original/hybrid}
- **Frequency:** {daily/weekly/biweekly}
- **Value proposition:** {1-2 sentences — why subscribe?}

## Growth Plan

### Month 1: Foundation
{Specific action items}

### Month 2-3: Early Growth
{Specific action items}

### Month 4-6: Scale
{Specific action items}

## Content Template
{Issue template/structure}

## Monetization Roadmap
{Timeline for monetization milestones}

Important Notes

  • Consistency matters more than frequency. A reliable weekly newsletter beats an erratic daily one.
  • Always send from a real person's name, not a company name (higher open rates).
  • The reply is the most underrated metric. Ask questions. Read and respond to replies.
  • Clean your list quarterly. A 5,000-subscriber list with 50% open rate is worth more than 20,000 with 15%.
  • Always have a "Why am I getting this?" link for new subscribers who forgot they signed up.

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

Files

Just SKILL.md in skills/newsletter of OpenClaudia/openclaudia-skills.

Open the folder on GitHubat commit 28bf209

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 skillOpenClaudia/openclaudia-skills713—~2kAutomated safety check: PassMIT
Shakespeare Writing StudioZCZHAO-1999/shakespeare-writing-studio178—~1.5kAutomated safety check: PassMIT
Content Trend Researcheralirezarezvani/claude-code-skill-factory8821 repos~2.1kAutomated safety check: PassMIT
Serenity Replyleslieyeo/serenity-reply135—~3kAutomated safety check: PassMIT
End-of-Article CTA Designersamber/cc-skills227—~3.1kAutomated safety check: PassMIT
Newsletter DigestVarnan-Tech/opendirectory674—~1.9kAutomated safety check: PassMIT

Similar skills

  • Shakespeare Writing Studio

    ZCZHAO-1999/shakespeare-writing-studio

    Produce publish-ready Chinese and English writing packages across WeChat articles, Medium/Substack essays, research notes, founder memos, op-eds, speeches, data storytelling, statistical graphics…

    178 GitHub stars~1.5k tokensUpdated 3 mo ago
    Writing & ContentAuto-check passed
  • Content Trend Researcher

    alirezarezvani/claude-code-skill-factory

    Advanced content and topic research skill that analyzes trends across Google Analytics, Google Trends, Substack, Medium, Reddit, LinkedIn, X, blogs, podcasts, and YouTube to generate data-driven…

    882 GitHub starsUsed in 1 repo~2.1k tokens
    Writing & ContentAuto-check passed
  • Serenity Reply

    leslieyeo/serenity-reply

    Serenity (@aleabitoreddit) 的思维框架与表达方式。基于 6 维度深度调研(1700+ 推文、Substack 长访谈、第三方分析、批评者观点), 提炼 5 个核心心智模型、8 条决策启发式和完整的表达 DNA。

    135 GitHub stars~3k tokensUpdated 4 mo ago
    Writing & ContentAuto-check passed
  • Interviews you about objective, audience and context, then designs an end-of-article call to action with copy, placement, A/B test plan and accessibility check.

    227 GitHub stars~3.1k tokensUpdated 10 days ago
    Writing & ContentAuto-check passed
  • Newsletter Digest

    Varnan-Tech/opendirectory

    Aggregates RSS feeds from the past week, synthesizes the top stories using Gemini, and publishes a newsletter digest to Ghost CMS.

    674 GitHub stars~1.9k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Idea Extractor

    aiskilloftheweek/claude-ai-skill-of-the-week

    Analyzes long-form content (transcripts, articles, interviews, webinars, podcast notes) and extracts the 3 best content ideas for any publishing platform — LinkedIn, Substack, blog, newsletter…

    149 GitHub stars~1.5k tokensUpdated 4 mo ago
    Writing & ContentAuto-check passed

More from OpenClaudia/openclaudia-skills

All 74 skills in this repo
  • Competitor Traffic Report

    OpenClaudia/openclaudia-skills

    Build an interactive competitive-traffic report for any company and its rivals — monthly visits (SimilarWeb), organic search traffic and Domain Rating (Ahrefs) — as one self-contained HTML page with…

    713 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Geo Difficulty

    OpenClaudia/openclaudia-skills

    Score how hard a keyword is to rank for in the AI-search era — page-level URL Rating of real competitors (not just domain DR), Ahrefs keyword difficulty, and whether a given site already ranks or is…

    713 GitHub stars~694 tokensUpdated today
    Auto-check passed
  • Gsc Portfolio Audit

    OpenClaudia/openclaudia-skills

    Audit EVERY Google Search Console property at once — rank all sites by clicks and impressions with period-over-period deltas, then diff keywords per site to surface what is newly ranking, rising…

    713 GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Similarweb Traffic

    OpenClaudia/openclaudia-skills

    Fetch website traffic estimates (monthly visits, traffic sources, top countries, keywords, engagement, ranks) for any domain from SimilarWeb.

    713 GitHub stars~882 tokensUpdated today
    Auto-check passed
  • Ahrefs Python

    OpenClaudia/openclaudia-skills

    Manages Ahrefs API usage in Python using ahrefs-python library.

    713 GitHub stars~1.9k tokensUpdated today
    Auto-check passed
  • Ab Test Setup

    OpenClaudia/openclaudia-skills

    Design, plan, and analyze A/B tests with statistical rigor. An agent skill from OpenClaudia/openclaudia-skills.

    713 GitHub stars~1.7k tokensUpdated today
    Auto-check passed

Works with

Questions about Newsletter

What does Newsletter do?

Plan and grow an email newsletter. An agent skill from OpenClaudia/openclaudia-skills. Newsletter is an agent skill from OpenClaudia/openclaudia-skills. Plan and grow an email newsletter.

When should I use Newsletter?

Newsletter fits situations like: the user says newsletter strategy; grow my newsletter; newsletter content; email newsletter.

How do I install Newsletter in Claude Code?

Run `npx skills add OpenClaudia/openclaudia-skills --skill newsletter -a claude-code`. Or copy the skill folder (skills/newsletter in OpenClaudia/openclaudia-skills) 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 OpenClaudia/openclaudia-skills --skill newsletter -a codex`. Or copy the skill folder (skills/newsletter in OpenClaudia/openclaudia-skills) 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 OpenClaudia/openclaudia-skills --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?

SKILL.md names no scripts, command-line tools or credentials: Newsletter is instructions for the agent only.

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. Review the folder before installing.

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 2k tokens (SKILL.md is roughly 8.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Newsletter?

Skills that share tags, products or a category with Newsletter: Shakespeare Writing Studio (ZCZHAO-1999/shakespeare-writing-studio, 178 stars), Content Trend Researcher (alirezarezvani/claude-code-skill-factory, 882 stars), Serenity Reply (leslieyeo/serenity-reply, 135 stars) and End-of-Article CTA Designer (samber/cc-skills, 227 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Newsletter?

OpenClaudia (a GitHub organization) maintains it in OpenClaudia/openclaudia-skills, which has 713 GitHub stars. The repository holds 74 skills in this directory. The repository was last updated on September 18, 2026.

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