Agent skill

opened-weekly-newsletter-writer

Creates Friday OpenEd Weekly digest newsletters consolidating the week's content. This skill should be used when creating the weekly newsletter, Friday digest, or compiling weekly content. Not for daily newsletters.

Stars 163
Forks 31

Install this agent skill to your Project

npx add-skill https://github.com/majiayu000/claude-skill-registry/tree/main/skills/other/other/opened-weekly-newsletter-writer

SKILL.md

OpenEd Weekly Newsletter Writer

Creates Friday digest newsletters synthesizing the week's content into six distinct newsletter sections, plus a bonus Phase 4 for creating Ed's Roundup Twitter thread strategy.

Content Engine Philosophy

This skill is part of a living system. Every time we run this workflow, we should be:

  1. Tightening - Finding friction points and removing them. If something takes too long or requires too many steps, note it for skill improvement.

  2. Connecting - Looking for ways to involve other skills without adding friction:

    • After drafting → newsletter-to-social for social spokes
    • After identifying quotes → nearbound check for tagging
    • After completion → outreach-email-draft for featured creators
    • Quality concerns → quality-loop for review
  3. Evolving - When we discover better patterns mid-workflow, ask permission to update this skill in real-time. The skill should encode what we learn.

  4. Proactive - After completing the newsletter, automatically offer:

    • Social post generation (6-9 posts)
    • Ed's Roundup Twitter thread
    • Outreach emails to featured creators
    • HubSpot draft export

The goal: Each run makes the next run better. Skills are energetic pathways - the more we use them, the sharper they get.

Not for: Monday-Thursday daily newsletters (use opened-daily-newsletter-writer).

Requirements: Flexible length (typically 1,500-2,500 words) • NO EMOJIS in body • Pirate Wires-influenced voice • All external links include source attribution in parentheses

Formatting Rules (Critical)

Images Above Titles

Thumbnail/header images ALWAYS go ABOVE the H1 section title, not below it:

![](image-url)

# Section Title Here

H1 for All Sections

Section titles use # (H1), not ## (H2). This applies to: Featured Podcast, Deep Dive, Trends, Tools, From the Community, Ed's Stable.

Opening Letter Has No Header

The opening letter starts immediately after the frontmatter - no ## OPENING LETTER header, no dividing line before it. Just launch into the content.

Include Links Early in Opening Letter

Include links to the podcast episode and deep dive article inline in the opening letter. Many readers won't scroll past the opening - give them the links up front.

Source Attribution Format

Put the source in italics right after the link, before the description:

[**Compelling Headline**](url) *(Source Name)* - Short teasing description.

NOT at the end of the paragraph: ...description. (Source Name)

Link Text = Compelling Headlines

Never just copy the article's actual title for link text. Write a compelling, curiosity-driven headline. Think: what would make someone stop scrolling? MFM energy - tease the value, open a loop.

Good: [**Why your kid struggles with algebra (it started in 3rd grade)**](url) Bad: [**Test Results Reveal a Deeper Issue in Math**](url)

Good: [**This school finishes all academics by 10am**](url) Bad: [**Alpha School Students Finish Academics in 2 Hours**](url)

Trends/Tools: Short and Teasing

1-2 sentences max per item. Don't explain the whole article - open a curiosity loop that earns the click. Leave something out. Tease the value.

Good: "Short passages 'better prepare them for high school,' they said. The real reason is more uncomfortable than that." Bad: "The richest public middle school in DC told parents their 8th graders won't read complete novels anymore. Short passages 'better prepare them for high school.' The author argues the real problem: we've confused difficult with boring, and are training kids to never wrestle with anything longer than a page."

Workflow

Phase 1: Gather & Organize Source Material

IMPORTANT EFFICIENCY NOTE: When the user provides source material directly (copy-pasted content, transcripts, links), DO NOT regenerate it token-by-token. Instead:

  • Ask the user to create the Source_Material.md file themselves by copy-paste
  • OR use Read tool if they've already created it
  • OR acknowledge what they've provided and move directly to Phase 2

Only create/write source material files when:

  • User asks you to organize scattered notes
  • User needs help structuring raw data
  • Content requires significant reorganization

Collect from the week:

  • Opening letter context (timely announcements, promotions, deadlines)
  • Deep Dive article with full text and author info
  • Deep Dive Podcast episode transcript or description
  • Additional curated links, tools, and other resources

If creating Source_Material.md, include:

  • All URLs, descriptions, and key quotes
  • Author names and titles
  • Statistics and data points
  • Engagement context (why this content matters)
  • Names and Twitter handles of people/organizations mentioned (for Phase 4 Twitter thread)

Phase 2: Draft Opening Letter

No header. The opening letter starts right after frontmatter - no ## OPENING LETTER, no divider.

Create opening section that:

  • Opens with greeting ("Happy Friday!" or similar)
  • Names the 1-2 conversations/stories that define this week
  • Includes inline links to the podcast and deep dive early (many readers won't scroll)
  • Connects the week's content with a through-line (what ties it all together?)
  • Keeps it conversational and specific - name people, reference moments
  • Signs off: "- Charlie (the OpenEd newsletter guy)"

Opening Letter Example Structure:

  1. Greeting
  2. Name the week's lead story with link (podcast, deep dive, or both)
  3. Name the second story with link
  4. One sentence connecting them (the through-line)
  5. "That's the thread this week."
  6. Charlie signature

Phase 3: Draft All Remaining Newsletter Sections

Create Weekly_Newsletter_Draft.md with six sections:

Featured Podcast (image above title)

![](thumbnail-url)

# Compelling Title for the Episode
  • By [Author Name] byline below title
  • Brief setup, then the story
  • One compelling moment or key insight
  • 2-3 direct quotes from transcript
  • Honest criticisms or nuance (shows we're not cheerleading)
  • Link to listen + link to read: [Listen](URL) | [Read the write-up](URL)

Deep Dive (image above title)

![](thumbnail-url)

# Compelling Title for the Article
  • 3-4 paragraphs, narrative style
  • Hook with compelling angle
  • Include key data point(s) or memorable quote
  • End with link: [Read the full deep dive](URL)

Trends We're Following

  • 4-6 items, each 1-2 sentences MAX
  • Compelling headline as link text (not the article's actual title)
  • Source in italics right after link: [**Headline**](url) *(Source)* - Tease.
  • Open a curiosity loop - don't explain the whole article
  • Focus on what makes each trend surprising or urgent

Tools We're Bookmarking

  • 6-10 resources, tools, curricula, or recommendations
  • Same format: [**Headline**](url) *(Source)* - Tease.
  • Each 1-2 sentences MAX - earn the click by leaving something out
  • Benefit-first, not feature-first
  • Reddit posts welcome here when they contain practical value (curriculum recs, milestone celebrations, etc.)

From the Community (optional section)

  • Voices from Reddit, X, blogs that don't fit neatly into Trends or Tools
  • More conversational/narrative than the link-heavy sections above
  • Good for: community conversations, viral moments, honest/uncomfortable threads
  • Format: **"Title"** *(Source)* - Brief description. [Link](url)

Ed's Stable

  • Closing synthesis that ties the week's through-line together
  • Can reference social media posts, carousels, or Facebook content from the week
  • Close with the question or idea that connects everything
  • Include links to blog + podcast at the bottom

Closing:

---

That's all for this week!

– Charlie (the OpenEd newsletter guy)

P.S. [Link to manage email preferences](#)

Phase 4: Create Ed's Roundup Twitter Thread Strategy

NEW PHASE: Create Twitter_Thread_Roundup.md (or Twitter_Thread_Roundup_V2.md if iterating)

This phase creates a multi-tweet thread that recaps the week's key stories and creators featured in the newsletter.

Step 1: Identify All Twitter Handles

  • Create a comprehensive list of every person/organization mentioned in the newsletter
  • Search Twitter/X for each to find active accounts and verify handles
  • Prioritize people who are:
    • Featured guests (podcasters, experts)
    • Content creators referenced (Austin Scholar, Adam Savage, Henrik Wes, etc.)
    • Organizations mentioned (LearningRx, Simply Charlotte Mason, etc.)
  • Format as: @handle (Name/Organization) - [brief context]

Step 2: Research Active Accounts

  • For each identified person/org, verify:
    • Do they have a Twitter account?
    • Is it active (posted in last 30 days)?
    • Should they be tagged in the thread?
  • Document in the Twitter thread file which handles are taggable

Step 3: Draft Twitter Thread

Opening Tweet (Hook):

  • Opens with brand identity: "Ed's Roundup: The most clicked education links from this week"
  • Or: "Here's what 10K+ readers of OpenEd Weekly are paying attention to"
  • States number of creators: "13 creators. 1 thread."
  • Includes emoji (horse/roundup theme): 🪶 or 🐴
  • Clear call to action: "(thread)"

Creator Tweets (One per major theme/person):

  • Feature person's name: @handle
  • Their contribution/insight (1 sentence max)
  • Direct quote if available
  • Link to their content or OpenEd's content about them
  • Use proven tweet structures: Direct Quote, Problem Recognition, Data Point, Contrarian Take, Observation Post

Closing Tweets:

  • Wrap-up tweet with CTA to OpenEd Daily/Weekly
  • Engagement tweet asking readers to reply with their favorite creators

Format Examples:

Tweet with direct quote:

"When we teach science as memorization, we're missing the point."

— @AdamSavage (MythBusters)

That quote started a conversation about why wonder matters more than worksheets.

Full deep dive: https://opened.co/blog/best-homeschool-science-curriculum

Tweet with problem/insight:

The reason your kid won't listen when you yell?

It's not defiance. It's neurology.

Dr. Amy Moore explains auditory exclusion: https://opened.co/blog/why-your-adhd-kid-wont-listen-its-not-what-you-think

Tweet with data:

1.5M students are now in microschools.

That's the same as Catholic schools.

Same enrollment. Different satisfaction rates.

@rebeleducator mapped it: [URL]

Reference Guide: See references/eds-roundup-example.md for complete real-world example from Nov 14, 2025 newsletter

Phase 5: Integrate Source Attributions

As sections are drafted, embed source attributions directly in the newsletter text. No separate URL_Mappings.md file needed.

Attribution Style: Mention the source by name EARLY in the blurb with a hyperlink woven naturally into the text. Avoid parenthetical citations at the end.

  • Good: "A Reddit mom of five shares her hard-won advice..."
  • Good: "New EdChoice polling found overwhelming support..."
  • Good: "A Penn Foster survey reported by USA Today found..."
  • Avoid: "...bouncing around opens you to gaps. (Reddit)"
  • Avoid: "...found overwhelming support for teaching debate. (EdChoice)"

The goal is conversational flow, not academic citation style.

Hyperlinking Rules: When provided a link, always hyperlink it in the body of the text (never at the end). Link the main action or subject using only 2-3 key words max.

Good: "Ken Danford has been running North Star since 1996..." Bad: "Ken Danford has been running North Star, a physical community center where teens can legally homeschool"

When multiple sources are provided with body text to reference, hyperlink ALL links where the referenced content is used. Don't let any provided link go unhyperlinked.

Phase 6: QA & Finalization

Quality Checklist:

  • NO EMOJIS in newsletter body text (OK in Twitter thread)
  • All external links include source attribution
  • Deep Dive article is compelling (not just a summary)
  • Podcast highlight is one moment, not overview
  • Trends section is data-driven with sources
  • Tools section leads with benefit, not features
  • Ed's Stable reflects actual brand moments
  • All links are verified and working
  • No duplicate content between sections
  • Pirate Wires tone consistent throughout
  • Opening letter includes all key announcements
  • Twitter thread handles are verified and active

Archive:

bash
cp [working-folder]/Weekly_Newsletter_DRAFT.md [archive-folder]/[YYYY-MM-DD]-newsletter-final.md
cp [working-folder]/Social_Media.md [archive-folder]/[YYYY-MM-DD]-social-media.md
cp [working-folder]/X_Article_Format.md [archive-folder]/[YYYY-MM-DD]-x-article.md

Reference Files

Each section of the newsletter has an example reference file with the actual format, real examples from a published newsletter, and specific instructions for writing that section:

  • Opening Letter Example - How to write warm, inclusive openings with clear CTAs
  • Deep Dive Example - Third-person teaser format that makes readers curious
  • Podcast Highlight Example - One compelling moment with quotes
  • Trends We're Following Example - Data-driven stories with source attribution
  • Tools We're Bookmarking Example - Benefit-first descriptions with sequential ordering
  • Ed's Stable Example - Social media highlights and brand moments
  • Ed's Roundup Twitter Thread Example - Complete Twitter thread with all creators tagged

Key Distinctions

Weekly vs Daily:

  • Daily: 500-800 words, 1 each Trend/Tool, shorter sections
  • Weekly: 1,500-2,500 words, 4-6 Trends, 10-15 Tools, deeper analysis

Newsletter Structure:

  • Opening Letter
  • Deep Dive Article (Wed article)
  • Podcast Highlight (Thu episode - one moment) — OPTIONAL: skip if no episode that week
  • Trends We're Following (data-driven stories, 4-5 items)
  • Tools We're Bookmarking (resources, curricula, 6-10 items, max 1 Reddit)
  • Ed's Stable (brand moments, social highlights, engagement ask)

Social Media Outputs (Phase 4):

  • Social_Media.md (handles table, X thread, single posts)
  • X_Article_Format.md (long-form article for X)

What's Removed:

  • "Listen for the Listeners" (too redundant with Trends)
  • "Reddit Corner" (content integrated into other sections as relevant)
  • "Parting Thought" (function now served by Ed's Stable closing)

Critical Reminders

❌ NO EMOJIS in newsletter body ❌ Don't skip Phase 1 (source material gathering) ❌ Deep Dive = Wed article ONLY (not podcast) ❌ Trends must have data ❌ No duplicate content between sections ❌ Twitter handles must be verified before tagging (never guess) ❌ No parenthetical attributions — weave source names early with hyperlinks ❌ Max ONE Reddit post in Tools section

✅ 1,500-2,500 words for newsletter ✅ Humanize stats with context ✅ Benefit-first approach for tools ✅ Create Social_Media.md with handles table, thread, single posts ✅ Create X_Article_Format.md for long-form posting ✅ Archive newsletter, social media, AND X article files

Phase 4: Social Media Protocol (UPDATED)

Create Social_Media.md with the following sections:

4.1 Verified Handles Table

Search and verify X/Twitter handles for all people and organizations mentioned in the newsletter. Document in a table:

Person/Org Handle Context Tag in thread?
[Name] @handle [Role/quote] ✅ or ❌

Note which are Instagram-only or Substack-only (no Twitter).

4.2 X Thread (8-12 tweets)

Structure:

  1. Hook tweet — List the main topics, end with "Thread 👇"
  2. Feature tweets — One per key person/insight, tag them directly
  3. CTA tweet — Links to newsletter, deep dive, subscribe

Tweet formats that work:

  • Direct quote + attribution + link
  • Contrarian observation + source
  • Data point + implication
  • "Meanwhile, @handle shared this..."

4.3 Single-Post Options (2-3 standalone posts)

Create 2-3 self-contained posts that can go out independently:

  • Best for viral potential (contrarian takes, surprising data)
  • Don't require the full thread context
  • Can be scheduled throughout the weekend

4.4 X Article Format

Create X_Article_Format.md — the full newsletter reformatted for X's long-form Articles feature:

  • Remove markdown formatting that doesn't render
  • Add @ mentions inline where people are quoted
  • Keep section headers
  • Ensure all links are full URLs

Expected Output Files:

[working-folder]/
├── Weekly_Newsletter_DRAFT.md
├── Social_Media.md          # Handles + thread + single posts
└── X_Article_Format.md      # Long-form X Article version

Success Metrics:

  • All mentioned creators identified with verified handles
  • Thread tags real, active accounts (not guessed)
  • Single posts have standalone viral potential
  • X Article is copy-paste ready

Related Skills

  • hook-and-headline-writing - For generating newsletter subject lines
  • social-content-creation - For repurposing newsletter sections into individual posts
  • video-caption-creation - For creating captions for clips featured in newsletter

Version History

  • v2.1 (2026-01-09): Social & Attribution Update

    • Attribution style changed: Source name early with hyperlink woven into text (not parenthetical at end)
    • Phase 4 expanded: Now includes X Article format, single-post options, handles verification table
    • Output files: Now creates Social_Media.md AND X_Article_Format.md
    • Tools section: Max ONE Reddit post per newsletter; 6-10 tools (down from 10-15)
    • Podcast section: Now optional (skip if no episode that week)
  • v2.0 (2025-11-14): MAJOR UPDATE

    • Simplified from 8 sections to 6 newsletter sections
    • Headers updated: "Trends We're Following" (not "What's Moving")
    • Headers updated: "Ed's Stable" (not "Parting Thought")
    • Removed: "Listen for the Listeners" and "Reddit Corner" (redundant)
    • ADDED: Phase 4 Twitter Thread Strategy ("Ed's Roundup")
    • Added comprehensive Twitter handle verification process
    • Added tweet structure examples and reference guide
  • v1.0 (Previous): Original 8-section structure with separate Podcast Corner and Reddit Corner


For detailed examples of the current structure, see the reference files folder and the Nov 14, 2025 newsletter implementation.

Expand your agent's capabilities with these related and highly-rated skills.

Didn't find tool you were looking for?

Be as detailed as possible for better results