publish-newsletter

Publish newsletter issues from campaign markdown into the OpenMates web app and email pipeline.

43|2|Updated Jan 25, 2024
One-click install
npx skills add https://github.com/glowingkitty/OpenMates --skill publish-newsletter
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: publish-newsletter
Source: https://github.com/glowingkitty/OpenMates/tree/main/.agents/skills/publish-newsletter
Command: npx skills add https://github.com/glowingkitty/OpenMates --skill publish-newsletter

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill solves the problem of keeping a newsletter issue’s web preview, i18n content, and email manifest in sync with your marketing campaign source files.

Core Features & Use Cases

  • Campaign-to-web & email publishing: Takes a campaign folder from openmates-marketing/campaigns/, runs the publisher to generate/update the newsletter manifest, demo chat, and i18n YAML.
  • Translation rebuild & app registration: Rebuilds frontend translations so the published newsletter appears correctly in the web app.
  • Optional test send: Sends a test email for the generated slug without running the real broadcast.

Use case example: You update a specific campaign’s English and German newsletter content, then publish it so the web app demo chat and the email payload are refreshed, and optionally verify delivery with a test email address.

Quick Start

Run the publish-newsletter Skill with the campaign folder name and optionally a test recipient to generate the newsletter assets and send a proof email.

Frequently Asked Questions about publish-newsletter

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I publish a newsletter from markdown to the web app and email pipeline?

To publish a newsletter, run the publish_newsletter.py script on your campaign folder to generate the email manifest, demo chat, and i18n YAML sources, then rebuild frontend translations and deploy the updated files.

Can I send a test email before broadcasting a newsletter to subscribers?

Yes, you can send a test email by running send_newsletter.py with the generated newsletter slug and a test recipient address, allowing you to verify delivery without executing the real broadcast.

How does newsletter publishing handle i18n and multiple locales?

Newsletter publishing handles i18n by generating locale-specific YAML sources from the campaign markdown and rebuilding frontend translations so the web app displays correctly across all supported languages.

What is needed to sync my marketing campaign markdown with the newsletter email manifest?

Syncing campaign markdown with the email manifest requires running the publisher script on the openmates-marketing campaign folder, which updates the newsletter manifest, demo chat, and i18n content together.

Does newsletter publishing update the web app demo chat automatically?

Yes, running the publisher script updates the web app demo chat automatically alongside generating the email manifest and i18n YAML, ensuring the demo reflects the latest campaign content.

What are the limitations of sending a newsletter test email with send_newsletter.py?

The test email functionality is limited to sending a proof to a specified recipient address using the generated slug, meaning it does not execute the actual broadcast to the full subscriber list.