Agent skill

Newsletter Engine

by revfactory in revfactory/harness-100

A full production pipeline where an agent team collaborates to generate newsletter content — curation, writing, A/B testing, and send optimization — all at once.

Apache-2.0Auto-check passedWriting & Content

Install Newsletter Engine

skills CLI
$ npx skills add revfactory/harness-100 --skill newsletter-engine -a claude-code

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

GitHub CLI
$ gh skill install revfactory/harness-100 newsletter-engine --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/revfactory/harness-100.git skills-src && mkdir -p .claude/skills && cp -r skills-src/en/03-newsletter-engine/.claude/skills/newsletter-engine .claude/skills/newsletter-engine && 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-engine
GitHub stars
1.3k
Token cost
~1.8k tokens
SKILL.md length
699 words
Files
1
Skills in repo
464
Repo updated
First seen
Licence
Apache-2.0

At a glance

A full production pipeline where an agent team collaborates to generate newsletter content — curation, writing, A/B testing, and send optimization — all at once.

  • Works in 3 steps: Preparation (Performed directly by the… → Team Assembly and Execution → Integration and Final Deliverables
  • Requests like write a newsletter
  • SKILL.md covers Execution Mode, Agent Roster, Workflow and Scope-Based Modes, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Newsletter Engine is an agent skill from revfactory/harness-100. A full production pipeline where an agent team collaborates to generate newsletter content — curation, writing, A/B testing, and send optimization — all at once. Use this skill for requests like 'write a newsletter,' 'newsletter planning,' 'email newsletter,' 'newsletter curation,' 'newsletter A/B test,' 'subscriber email,' 'weekly newsletter,' 'newsletter send optimization,' and other newsletter production tasks. Also supports editing and optimization when existing content is provided. Note: email sending system…

Its SKILL.md is about 1.8k 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 and A/B testing. It works with Mailchimp. The licence is Apache-2.0.

When your agent uses it

  • Requests like write a newsletter
  • Newsletter planning
  • Email newsletter
  • Newsletter curation

Example prompts

  • “write a newsletter,”
  • “newsletter planning,”
  • “email newsletter,”
  • “/newsletter-engine”

Workflow steps

3 steps, taken from the step headings in SKILL.md.

  1. Preparation (Performed directly by the orchestrator)
  2. Team Assembly and Execution
  3. Integration and Final Deliverables

What it can do on your machine

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

    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 Engine loads about 1.8k tokens when it runs. Until then it costs about 168 tokens; SKILL.md has 699 words of instructions outside code blocks.

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

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 revfactory/harness-100 at commit 8e8d35c, republished under its Apache-2.0 licence (© revfactory). 699 words, ~1,828 tokens.

Download SKILL.mdSave it as .claude/skills/newsletter-engine/SKILL.md (or your agent's skills folder).
name
newsletter-engine
description
A full production pipeline where an agent team collaborates to generate newsletter content — curation, writing, A/B testing, and send optimization — all at once. Use this skill for requests like 'write a newsletter,' 'newsletter planning,' 'email newsletter,' 'newsletter curation,' 'newsletter A/B test,' 'subscriber email,' 'weekly newsletter,' 'newsletter send optimization,' and other newsletter production tasks. Also supports editing and optimization when existing content is provided. Note: email sending system (Mailchimp, ConvertKit) API integration, subscriber database management, and actual A/B test execution are outside this skill's scope.

Newsletter Engine — Full Newsletter Production Pipeline

An agent team collaborates to produce newsletters through the pipeline of curation → writing → A/B testing → editing → publishing, all at once.

Execution Mode

Agent Team — 5 members communicate directly via SendMessage and cross-validate each other's work.

Agent Roster

AgentFileRoleType
curator.claude/agents/curator.mdSource collection, trend analysis, content selectiongeneral-purpose
copywriter.claude/agents/copywriter.mdHeadlines, body copy, CTA writinggeneral-purpose
analyst.claude/agents/analyst.mdA/B test design, send optimizationgeneral-purpose
editor-in-chief.claude/agents/editor-in-chief.mdTone consistency, final editinggeneral-purpose
quality-reviewer.claude/agents/quality-reviewer.mdCross-validation, consistency checksgeneral-purpose

Workflow

Phase 1: Preparation (Performed directly by the orchestrator)
  1. Extract from user input:
    • Topic/Theme: The subject the newsletter will cover
    • Newsletter Info (optional): Brand tone, subscriber count, publication frequency
    • Target Reader (optional): Subscriber characteristics, interests
    • Constraints (optional): Length, specific section requirements
    • Existing Files (optional): Content, previous issues, etc. provided by the user
  2. Create the _workspace/ directory at the project root
  3. Organize the input and save it as _workspace/00_input.md
  4. If existing files are provided, copy them to _workspace/ and skip the corresponding phase
  5. Determine the execution mode based on request scope
Phase 2: Team Assembly and Execution
OrderTaskOwnerDepends OnDeliverable
1Content curationcuratorNone_workspace/01_curation_brief.md
2Newsletter writingcopywriterTask 1_workspace/02_newsletter_draft.md
3A/B test designanalystTasks 1, 2_workspace/03_ab_test_plan.md
4Final editingeditor-in-chiefTasks 2, 3_workspace/04_editorial_final.md
5Quality reviewquality-reviewerTasks 2, 3, 4_workspace/05_review_report.md

Inter-agent communication flow:

  • curator complete → deliver angles & content to copywriter, trending keywords to analyst
  • copywriter complete → deliver A/B variant materials to analyst, draft to editor-in-chief
  • analyst complete → deliver send optimization & A/B recommendations to editor-in-chief
  • editor-in-chief complete → deliver final version to quality-reviewer
  • reviewer cross-validates all deliverables. On 🔴 Must Fix: request revision → rework → re-validate (up to 2 rounds)
Phase 3: Integration and Final Deliverables
  1. Verify all files in _workspace/
  2. Confirm all 🔴 Must Fix items have been addressed
  3. Report the final summary to the user:
    • Curation Brief — 01_curation_brief.md
    • Newsletter Draft — 02_newsletter_draft.md
    • A/B Test Plan — 03_ab_test_plan.md
    • Editor-in-Chief Final — 04_editorial_final.md
    • Review Report — 05_review_report.md

Scope-Based Modes

User Request PatternExecution ModeAgents Deployed
"Plan a newsletter," "full production"Full PipelineAll 5
"Just write the newsletter copy"Copy Modecurator + copywriter + quality-reviewer
"Make a newsletter from this content" (existing file)Edit Modecopywriter + editor-in-chief + quality-reviewer
"Design an A/B test" (existing newsletter)Analysis Modeanalyst + quality-reviewer
"Review this newsletter"Review Modequality-reviewer only

Using Existing Files: If the user provides content or a previous newsletter, copy it to the appropriate location in _workspace/ and skip that phase.

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

Data Transfer Protocol

StrategyMethodPurpose
File-based_workspace/ directoryPrimary deliverable storage and sharing
Message-basedSendMessageReal-time key information transfer, revision requests
Task-basedTaskCreate/TaskUpdateProgress tracking, dependency management

File naming convention: {order}_{deliverable}.{extension}

Error Handling

Error TypeStrategy
Web search failureCurator works from user-provided materials, notes "real-time data not reflected"
Brand tone unclearApply default tone (professional + friendly), editor-in-chief recommends tone refinement after first issue
Agent failureRetry once → if still failing, proceed without that deliverable, note omission in review report
🔴 found in reviewRequest revision from responsible agent → rework → re-validate (up to 2 rounds)

Test Scenarios

Happy Path

Prompt: "Create a weekly newsletter covering AI industry trends. Target audience: developers. Tone: professional with wit" Expected Results:

  • Curation: 5+ latest AI articles, trend analysis, recommended resources
  • Copy: Subject line (A/B 2 variants), preheader, intro + main story + sub stories + resources + closing
  • Analysis: 2 A/B tests (subject line, CTA), send time recommendations, performance forecast
  • Editorial: Tone review, legal check, final version
  • Review: All consistency matrix items verified
Existing File Flow

Prompt: "Make a newsletter from this collection of articles" + content file attached Expected Results:

  • Existing content organized into _workspace/01_curation_brief.md
  • Edit Mode: copywriter + editor-in-chief + quality-reviewer deployed
  • curator skipped
Error Flow

Prompt: "Just design A/B tests for this newsletter subject line" Expected Results:

  • Switch to Analysis Mode (analyst + quality-reviewer)
  • No newsletter body exists, so analyst proposes subject-line-pattern-based A/B variants
  • Review report notes "body copy/curation not generated"

Agent Extension Skills

Each agent leverages the following extension skills to enhance deliverable quality:

AgentExtension SkillKnowledge Provided
copywriter/email-copywritingCURVE subject line framework, CTA design, F-pattern body structure
analyst, curator/audience-segmentationBEAR segmentation model, send time optimization, welcome series
editor-in-chief, analyst/deliverability-optimizationSpam filter avoidance, Gmail Promotions tab strategies, legal compliance

© revfactory, Apache-2.0. 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 en/03-newsletter-engine/.claude/skills/newsletter-engine of revfactory/harness-100.

Open the folder on GitHubat commit 8e8d35c

Compare with similar skills

Newsletter Engine 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 Engine compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Newsletter Engine this skillrevfactory/harness-1001.3k—~1.8kAutomated safety check: PassApache-2.0
End-of-Article CTA Designersamber/cc-skills228—~3.1kAutomated safety check: PassMIT
Email NewsletterVarnan-Tech/opendirectory674—~4.4kAutomated safety check: PassMIT
Linkedin Post Experimentationhashgraph-online/awesome-codex-plugins1.3k—~587Automated safety check: PassMIT
Subject Line Labcognyai/claude-code-marketing-skills104—~2kAutomated safety check: NotesNone
Internal Communications Writeranthropics/skills180k38 repos~378Automated safety check: PassApache-2.0

Similar skills

  • 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.

    228 GitHub stars~3.1k tokensUpdated 8 days ago
    Writing & ContentAuto-check passed
  • Email Newsletter

    Varnan-Tech/opendirectory

    Drafts and designs a complete HTML email newsletter from a topic or content brief.

    674 GitHub stars~4.4k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Linkedin Post Experimentation

    hashgraph-online/awesome-codex-plugins

    Plan, measure, and iterate LinkedIn content experiments using post hypotheses, format tests, analytics, comments, and learning loops.

    1.3k GitHub stars~587 tokensUpdated today
    Writing & ContentAuto-check passed
  • Subject Line Lab

    cognyai/claude-code-marketing-skills

    Mine your actual subject-line history from Klaviyo / Mailchimp / Rule / Get a Newsletter, find the patterns that work for YOUR list, and generate tuned candidates

    104 GitHub stars~2k tokensUpdated 3 mo ago
    Marketing & SEOAuto-check: notes
  • Official

    A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill…

    180k GitHub starsUsed in 38 repos~378 tokens
    Writing & ContentAuto-check passed
  • Clarity

    addyosmani/clarity

    Draft, rewrite, or review reader-facing prose so it is specific, useful, and recognizably the author's without inventing facts or performing humanness.

    268 GitHub starsUsed in 1 repo~1.9k tokens
    Writing & ContentAuto-check passed

More from revfactory/harness-100

All 464 skills in this repo
  • Anti Bot Analyzer

    revfactory/harness-100

    A skill for analyzing website anti-bot defense mechanisms and developing legitimate evasion strategies.

    1.3k GitHub stars~1.1k tokensUpdated 6 mo ago
    Auto-check passed
  • API Error Design Patterns

    revfactory/harness-100

    Reference for designing how an API reports failures: structured error codes, response shapes, client-friendly messages, an error catalog and retry or fallback advice.

    1.3k GitHub stars~1.6k tokensUpdated 6 mo ago
    Auto-check passed
  • API Security Checklist

    revfactory/harness-100

    Walks a backend-dev agent through OWASP API Top 10 checks, authentication and authorization patterns, and defense code during API design.

    1.3k GitHub stars~1.7k tokensUpdated 6 mo ago
    Auto-check passed
  • Arg Parser Generator

    revfactory/harness-100

    Methodology for systematically designing and generating CLI tool argument parser structures.

    1.3k GitHub stars~1.2k tokensUpdated 6 mo ago
    Auto-check passed
  • Audience Segmentation

    revfactory/harness-100

    Audience segmentation skill used by the analyst and curator agents.

    1.3k GitHub stars~1.3k tokensUpdated 6 mo ago
    Auto-check passed
  • Audio Storytelling

    revfactory/harness-100

    Audio storytelling skill used by the podcast scriptwriter and show note editor.

    1.3k GitHub stars~1.6k tokensUpdated 6 mo ago
    Auto-check passed

Works with

Questions about Newsletter Engine

What does Newsletter Engine do?

A full production pipeline where an agent team collaborates to generate newsletter content — curation, writing, A/B testing, and send optimization — all at once. Newsletter Engine is an agent skill from revfactory/harness-100. A full production pipeline where an agent team collaborates to generate newsletter content — curation, writing, A/B testing, and send optimization — all at once.

When should I use Newsletter Engine?

Newsletter Engine fits situations like: requests like write a newsletter; newsletter planning; email newsletter; newsletter curation.

How do I install Newsletter Engine in Claude Code?

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

How do I install Newsletter Engine in Codex?

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

Can I use Newsletter Engine 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 revfactory/harness-100 --skill newsletter-engine -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-engine, .gemini/skills/newsletter-engine, .github/skills/newsletter-engine and .opencode/skills/newsletter-engine in your project.

What does Newsletter Engine need to run?

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

Does Newsletter Engine 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 Engine 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 Engine use?

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

How many tokens does Newsletter Engine use?

About 1.8k tokens (SKILL.md is roughly 7.3k 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 Engine?

Skills that share tags, products or a category with Newsletter Engine: End-of-Article CTA Designer (samber/cc-skills, 228 stars), Email Newsletter (Varnan-Tech/opendirectory, 674 stars), Linkedin Post Experimentation (hashgraph-online/awesome-codex-plugins, 1.3k stars) and Subject Line Lab (cognyai/claude-code-marketing-skills, 104 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Newsletter Engine?

revfactory (a GitHub user) maintains it in revfactory/harness-100, which has 1,295 GitHub stars. The repository holds 464 skills in this directory. The repository was last updated on March 22, 2026.

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