newsletter-publisher
Prepare newsletters for publication by validating format, structure, frontmatter, and content. Use when reviewing drafts before sending.
When & Why to Use This Skill
The Newsletter Publisher skill is a specialized editorial tool designed to automate the pre-publication review process. It ensures newsletter drafts adhere to strict formatting, structural, and stylistic guidelines, such as en-GB spelling and specific heading hierarchies. By identifying technical 'red flags' like nested HTML tags and validating frontmatter metadata, this skill streamlines the transition from draft to delivery, ensuring a professional and consistent reader experience.
Use Cases
- 1. Pre-Publication Quality Assurance: Automatically audit newsletter drafts for structural integrity, ensuring all sections from 'Highlights' to 'Deep Dives' are present and correctly ordered.
- 2. Technical Compliance & Layout Protection: Detect and fix common HTML-breaking issues, such as links placed within headings, to ensure the newsletter renders correctly across all email clients.
- 3. Brand Voice & Style Standardization: Enforce specific linguistic requirements (e.g., British English) and conversational tones across various contributors to maintain a unified brand identity.
- 4. Metadata & Frontmatter Validation: Verify that technical headers, including titles, dates, and publication status, are correctly formatted for seamless integration with CMS or static site generators.
| name | newsletter-publisher |
|---|---|
| description | Prepare newsletters for publication by validating format, structure, frontmatter, and content. Use when reviewing drafts before sending. |
| allowed-tools | Read, Edit, Glob |
Newsletter Publisher
Validate and prepare newsletters for publication to ensure consistency and readiness.
Quick Start
Check newsletter draft for:
- Frontmatter - Title format, date, published field
- Structure - Opening → Highlights → Deep Dives → What's Coming → Closing
- Voice - First-person, conversational, en-GB
- Links - No links in headings (causes nested
<a>tags)
Critical Checks
Must Have
- ✅ Title format: "[Playful Title] - [Month Year]"
- ✅ H2 headings only (no H1)
- ✅ First-person voice
- ✅ en-GB spelling throughout
- ✅ Links in paragraph text, NOT in headings
Structure
- Opening prose (no heading)
- Highlights section
- Technical Deep Dives
- What's Coming preview
- Brief closing (no heading)
Common Issues
Red Flag: Links in headings - causes nested <a> tags in HTML
Fix: Use plain heading + link in paragraph below
References
For complete checklist and detailed guidelines: