Search the docs, videos, blog, apps, teams, skills and release notes.
At a glance
What it is
Plan a recurring newsletter that keeps your audience engaged between purchases. Set a cadence, one repeating format and one call to action per send.
A skill is a written procedure a bot loads when a job calls for it. This one is a single file, SKILL.md, and the whole file is on this page.
Each of these library teams gives its bots this skill. Import one and look inside first.
The whole file, exactly as it downloads. Read it before you rely on it.
SKILL.md
96 lines · 818 words
As of: 2026-10-02
Plan and run a recurring email that readers look forward to and that moves some of them to act.
Use when a business has or wants a list and needs a repeating broadcast: what to send, how often, in what format, and how to keep it deliverable and lawful.
Trigger phrases:
"Should I start a newsletter?"
Plan a recurring newsletter that keeps your audience engaged between purchases. Set a cadence, one repeating format and one call to action per send.
Nothing. It ships with Murage, which is open source. Your bots run on the AI plan you already have.
Yes. Open it in Settings → Skills to read, edit or duplicate it. Skill Guard scans it again after every edit.
Download the app, connect the AI you already pay for, and tell your Chief of Staff what needs doing. Plan on about ten minutes from install to a working team.
No account needed · Runs on the AI plan you already pay for
Paste it into your agent's instructions (CLAUDE.md, AGENTS.md or a custom GPT), or add it to a bot in Murage.
Ask Ember for the bot, then switch the skill on in its settings.
Step 1
Send your Chief of Staff this message. It proposes the bot and its role first, and creates it when you say go.
Send this to Ember
“Create a bot that uses the Newsletter skill, and show me the plan first.”
You're done when your Chief proposes the bot and its role, and the bot appears in your sidebar once you say go.
Step 2
You're done when you see the bot’s skills and the library.
Step 3
You're done when the skill shows as on for that bot.
Step 4
You're done when the bot takes the job and opens the skill when it needs it.
Prefer to do it yourself? Choose + in the sidebar, then New Bot.Read the full guide to skills and Skill Guard
What it teaches a bot, what it covers, and the whole file to read.
The principle
Plan and run a recurring email that readers look forward to and that moves some of them to act.
What it covers
When to use
Inputs to ask for
Procedure
Metrics and what good looks like
Failure modes
Hand-offs
"How often should I email my list?"
"My open rates are dropping."
Do not use for automated flows such as welcome or sales sequences (beacon-email-sequences). Do not use to grow a list from nothing; that needs a lead magnet and traffic (beacon-funnel-build). If no one has agreed to hear from you, fix consent first.
Who is on the list, how they joined, and how many.
The reader's problem and what they would be glad to receive every week.
Sending tool, sending domain, and whether authentication is set up.
Time available per issue and who writes.
The one action you most want readers to take.
Countries your readers live in.
1. Name the promise. One sentence: "Every [day], [reader] gets [benefit] in [minutes] minutes." Put it on the signup page and in the welcome email.
2. Pick one repeating format. Readers value a familiar shape. Options: one idea and one example; three curated links with your take; a customer story with a lesson; a short teardown. Choose a format you can produce at the same quality for six months.
3. Set the cadence. Weekly suits most businesses. Fortnightly is fine if each issue is strong. Daily needs a team. Pick a fixed day and time and keep it for two months before judging.
4. Build the issue layout.
Subject line: specific, honest, under about 50 characters.
Preview text that adds to the subject.
Opening line that gives the reason to read.
Body in the chosen format, short paragraphs, one image at most.
One call to action with one button. Secondary links stay as plain text.
Footer with unsubscribe link, your name and a physical mailing address.
5. Keep the list deliverable.
Authenticate the sending domain with SPF, DKIM and DMARC.
Bulk senders to Gmail and Yahoo (over about 5,000 a day) must also offer one-click unsubscribe and keep the spam complaint rate under 0.30 percent. Aim under 0.10.
Honor unsubscribes promptly. The US CAN-SPAM Act sets a limit of 10 business days; one click and same day is better.
Remove or re-confirm readers who have not opened in 90 to 180 days. Send a final "still want this?" email before removing.
Warm up a new domain slowly.
6. Get consent right.
US: CAN-SPAM requires a truthful sender and subject, a postal address, a clear opt-out, and labelling of ads. Penalties run to tens of thousands of dollars per email.
EU and UK: get clear opt-in consent, keep a record of when and how it was given, make withdrawal as easy as signing up. The UK allows a narrow "soft opt-in" only for similar products to existing customers who were offered an opt-out at the time.
Never import a bought list.
7. Grow with intent. Add a signup box at the end of every post, a pinned social link, a referral mention in each issue, and a swap with a partner newsletter whose audience matches. Track the source of each signup.
8. Review monthly. Look at clicks, replies, unsubscribes and complaints by issue. Keep the formats that earn replies.
Click rate on the main link: the best signal. Open rates are distorted by mail privacy features, so read them as a trend only.
Reply rate: even a few replies per hundred show a real audience.
Unsubscribe rate: under 0.5 percent per issue is typical.
Spam complaints: under 0.1 percent.
Revenue or leads per issue, tracked by tagged link.
Net list growth per month, after removals.
No repeating format, so each issue is a fresh scramble.
Several calls to action in one send.
Selling in every issue. Aim for mostly useful content and a clear ask once in a while.
Missing authentication or a hidden unsubscribe link.
Mailing a dormant list and wrecking the sender reputation.
Inconsistent schedule.
Judging on open rate alone.
Automated flows: beacon-email-sequences.
List-building funnel: beacon-funnel-build.
Content topics: beacon-blog-content.
Retention of buyers: lens-cohort-and-retention.
Draft review: verdict-flag-and-fix.
SKILL.md
96 lines · 818 words
The text of SKILL.md is shown as it downloads, under the Apache-2.0 license, by Ferrox Labs. The license is the one in the file's own frontmatter.
Your new bot
Newsletter bot
Waiting in your sidebar once you say go.
No account needed · Runs on the AI plan you already pay for