newsletter-voice
Build newsletter writing instructions inside a Cowork project. Runs after voice-builder. Produces newsletter-voice.md, a single file Claude references when drafting newsletters in the user's voice. Works with or without existing newsletter samples: if the user has past issues, the skill analyses the
By charlie947 · 956 installs
npx skills add charlie947/social-media-skills --skill newsletter-voice
Source repository · Upstream listing
Newsletter Voice
Prerequisites check
The moment this skill is triggered, check the project root for voice.md and about me.md.
If either file is missing, tell the user:
Newsletter voice sits on top of your general voice profile. Run voice builder first (upload the skill or say "build my voice"), then come back here once about me.md and voice.md are in the project.
Then stop. Do not continue until both files exist.
If both files exist, read them fully, then go straight to Step 1.
Step 1. Check for samples
Ask the user in chat:
Do you have 2 to 3 past newsletter issues I can learn from?
Yes: paste them here (one per message or all at once)
No: type "archetype" and I will build from a template tuned to your voice
Wait for response.
If the user pastes 2 or more newsletters, go to Step 2a.
If the user types "archetype", go to Step 2b.
If the user pastes 1 newsletter, ask for at least one more. If they only have one, offer: "One sample is not enough for pattern detection. Want me to switch to archetype mode and use your one newsletter as a reference point?"
Step 2a. Sample based analysis
Read every newsletter fully. Look for patterns across issues, not one off quirks. Extract:
Opening formula
What the first 3 sentences do (specific result, cultural observation, claim, scene, question)
Length of the opening section before the first structural break
Credibility move (how the author establishes authority early)
Value promise (what the reader is told they will get)
Section structure
Problem or contrast setup
Named framework or free prose
Numbered steps, methods, or continuous argument
Examples and evidence patterns
Bonus or extension section
Closing formula and signoff
Data philosophy
Specific numbers per issue (count them)
Source attribution style (linked, named, uncredited)
Example to abstraction ratio
Limitation or failure acknowledgements
Formatting
Header usage (frequency, hierarchy)
List usage (numbered, bulleted, arrows)
Bold and italic usage
Prompt, code block, or blockquote formatting
Visual markers (arrows, checkmarks, emojis if any)
Length
Word count range across samples
Section word counts
Voice markers unique to newsletter format
Pro tips or callouts (frequency, format)
Forward looking closings
Signoff phrase if consistent across samples
Meta transparency (does the author reflect on the process or ask for feedback)
Absence signals
Words, constructions, or structures absent from every sample
Closing moves the author never uses
Topics the author never touches
Then go to Step 3.
Step 2b. Archetype selection
Call the AskUserQuestion tool with a single question:
After the user picks an archetype, load the matching defaults from references/archetypes.md inside this skill folder. Tune every field using voice.md and about me.md before writing newsletter voice.md. Flag inside the output file that archetype defaults were used and the file should be revisited after 5 published issues.
Step 3. Write newsletter voice.md
Create newsletter voice.md in the project root. Single file, 800 to 1,200 words target. Use this structure:
Fill every section from the samples (or tuned archetype defaults). No generic filler. If the samples do not cover something, say "no clear pattern across samples" rather than guessing.
Step 4. Confirm and hand off
Tell the user:
Your newsletter voice is built. newsletter voice.md is in your project root alongside about me.md and voice.md. When you want to draft an issue, say "write a newsletter" and I will use all three files together.
[If archetype mode: Remember this file was built from archetype defaults. After 5 or so published issues, re run this skill with your real samples for a sharper profile.]
What this skill produces
One file in the project root:
newsletter voice.md: newsletter specific writing instructions covering audience, voice principles, opening formula, section flow, data philosophy, formatting, closing, absence patterns, and length targets
Rules
Require voice.md and about me.md in the project root before running. Stop and redirect to voice builder if either is missing.
Minimum 2 newsletter samples if the user chooses sample based mode. Offer archetype mode if fewer.
Keep newsletter voice.md under 1,200 words. Tight beats exhaustive.
Do not invent voice signals. Work only from samples or archetype defaults tuned to voice.md.
Do not duplicate content from voice.md. Reference it where relevant. newsletter voice.md adds newsletter specific rules only.
Do not bake in the user's specific names, URLs, or signoff phrases unless they appear consistently across 2 or more samples.
Do not produce a separate voice or banned words file. Absence patterns live inside newsletter voice.md as a single section.
British English throughout unless samples are clearly American.
Never use em dashes in any output file or in any draft.