---
name: "skill-newsletter-writing"
type: skill
description: 'Draft''s craft for writing a retail venture''s editorial newsletter issue: the issue anatomy, the template brief for Pixel and the drafting steps. Use when an issue is due and Reach has briefed it, or when the template needs designing or revising. Reach keeps the newsletter''s strategy, calendar, list growth, tooling and measurement in skill-newsletter-strategy. A venture''s customer newsletter only; the Mr Pritchard Substack is convention-mrp-voice''s.'
license: CC BY-NC-SA 4.0
---

# newsletter-writing

Draft's writing craft for the editorial send. `skill-newsletter-strategy` (Reach) decides what the newsletter is for, who gets it, how often, what the signup promise says, what each issue is about and when it goes; this skill turns an issue brief into the issue. It reads the venture's voice reference through `convention-brand` and writes to `standard-writing`.

## Trigger

- An issue is due and Reach has briefed it (calendar slot, bank entry, product facts, the action the issue moves).
- The venture needs its issue template designed or revised.

Retail ventures only. Not the Mr Pritchard Substack, which is personal editorial under `convention-mrp-voice`.

## Behaviour

### Pass 1 — the issue anatomy and template

One repeatable anatomy, so an issue is a fill, not a design: **opening** (a few lines in the voice, one idea); **one story** (the issue's format, at its natural length); **one product moment** (a single product or set, in use, with its price and a plain link); **one call to action** (one, never a row of buttons); a **sign-off** (for BARA, the Welsh sign-off is Aled's and is judged in execution, per `convention-brand`).

Working rules the Owner can strike: read time **two to four minutes**; image-to-text roughly **one image per story beat**, never an image-only issue; mobile-first at a single column; alt text on every image per `convention-shopify`'s frame-not-product rule; plain-text fallback carries the same story.

Hand the template to Pixel as a `skill-creative-brief` against the venture's `convention-brand` instance — palette, type, imagery direction — and record where the template lives. Where a brand field is a marked gap (BARA type and logo, at the time of writing), the brief says so and the template ships with the gap named, not filled.

### Pass 2 — the issue

Per issue: take the slot, the bank entry and the product facts from Reach's brief (product facts come from the store, never from memory). Settle the angle, then write the story to its format. Draft the subject line and preview text as variants where a test is intended. Assemble in the template. Check the anatomy, the alt text, the links and the unsubscribe, then run the check in `standard-writing` against the brief and the voice reference. File for Aled's review with the send date. The send goes to the operator staged, not sent.

Where the bank entry has no captured detail behind it, outline the issue and leave it undrafted; report the gap to Reach. Never fill a maker story from inference.

## Guardrails

- Voice is the venture's, read from its voice reference through `convention-brand`; never the Mr Pritchard voice, never generic marketing. Off-voice is a failure even if it performs.
- Story-first. An issue with no story is a promotion, and belongs to `skill-launch-campaign` or `skill-lifecycle`, not here.
- No manufactured urgency, no evergreen discount, no countdown; a genuine dated drop is on-voice and stated plainly.
- Product facts, prices and availability come from the store; never invented.
- Sending to a full list is a human action at `convention-shopify`'s boundary — staged and handed over, every time.
- Proposes to canon and files to Linear; never changes tooling, lists or store data itself.

## Setup

Run on demand by Draft when Reach briefs an issue. Connectors: Shopify (read), Linear. Carved from `skill-newsletter-strategy` Passes 2 and 4. On finish, run `skill-ops-retro` capture on this run's friction: file a `FRICTION:` note to the Pulse queue for the drain to assess.

Owned by Draft (DR-4FT).
