Agent skill

Newsletter Generator

by bytedance in bytedance/deer-flow

Researches a topic and drafts a ready-to-send newsletter in Markdown, such as a weekly roundup, daily digest or industry briefing, with curated links and commentary.

MITAuto-check passedWriting & Content

Install Newsletter Generator

skills CLI
$ npx skills add bytedance/deer-flow --skill newsletter-generation -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install bytedance/deer-flow newsletter-generation --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/bytedance/deer-flow.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/public/newsletter-generation .claude/skills/newsletter-generation && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
newsletter-generation
GitHub stars
84k
Used in
1 other repo
Token cost
~3.2k tokens
SKILL.md length
1,137 words
Files
1
Skills in repo
23
Repo updated
First seen
Licence
MIT

At a glance

Researches a topic and drafts a ready-to-send newsletter in Markdown, such as a weekly roundup, daily digest or industry briefing, with curated links and commentary.

  • Works in 4 steps: Planning → Research & Curation → Writing → …
  • Drafting a weekly roundup of news in a specific industry
  • SKILL.md covers Overview, Core Capabilities, When to Use This Skill and Newsletter Workflow, plus 4 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

The agent starts by pinning down a short list of parameters: the topics, the format (daily digest, weekly roundup, deep-dive or industry briefing, with weekly roundup as the default), the audience, the tone, the length (about a 5, 10 or 15-minute read) and the number of sections, which defaults to four to six. It also asks whether this is a one-off or part of a recurring series that needs consistent structure and branding.

It then gathers material from several web sources, writes headlines, summaries and its own commentary, and keeps links and attributions in the text. The result is a Markdown file that can go to an email platform, be published on the web or be converted to HTML. Tone can shift between technical, executive and general readers. The excerpt ends during the planning phase, so later steps are not covered here.

When your agent uses it

  • Drafting a weekly roundup of news in a specific industry
  • Turning a pile of recent links on one topic into a curated digest
  • Setting up a repeatable format for a recurring newsletter series

Example prompts

  • “Create a newsletter about this week's developments in open-source databases.”
  • “Write a weekly digest for our engineering managers, conversational but short.”
  • “Generate a tech roundup with five sections and a short commentary under each item.”

Requirements

  • Web search access to gather current sources

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Planning
  2. Research & Curation
  3. Writing
  4. Assembly & Polish

What it can do on your machine

Read from SKILL.md and the folder at commit 8a3350a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are markdown).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Newsletter Generator loads about 3.2k tokens when it runs. Until then it costs about 113 tokens; SKILL.md has 1,137 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~113
When it runs · the whole SKILL.md, loaded when a task matches
~3.2k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from bytedance/deer-flow at commit 8a3350a, republished under its MIT licence (© bytedance). 1,137 words, ~3,193 tokens.

Download SKILL.mdSave it as .claude/skills/newsletter-generation/SKILL.md (or your agent's skills folder).
name
newsletter-generation
description
Use this skill when the user requests to generate, create, write, or draft a newsletter, email digest, weekly roundup, industry briefing, or curated content summary. Supports topic-based research, content curation from multiple sources, and professional formatting for email or web distribution. Trigger on requests like "create a newsletter about X", "write a weekly digest", "generate a tech roundup", or "curate news about Y".

Newsletter Generation Skill

Overview

This skill generates professional, well-researched newsletters that combine curated content from multiple sources with original analysis and commentary. It follows modern newsletter best practices from publications like Morning Brew, The Hustle, TLDR, and Benedict Evans to produce content that is informative, engaging, and actionable.

The output is a complete, ready-to-publish newsletter in Markdown format, suitable for email distribution platforms, web publishing, or conversion to HTML.

Core Capabilities

  • Research and curate content from multiple web sources on specified topics
  • Generate topic-focused or multi-topic newsletters with consistent voice
  • Write engaging headlines, summaries, and original commentary
  • Structure content for optimal readability and scanning
  • Support multiple newsletter formats (daily digest, weekly roundup, deep-dive, industry briefing)
  • Include relevant links, sources, and attributions
  • Adapt tone and style to target audience (technical, executive, general)
  • Generate recurring newsletter series with consistent branding and structure

When to Use This Skill

Always load this skill when:

  • User asks to generate a newsletter, email digest, or content roundup
  • User requests a curated summary of news or developments on a topic
  • User wants to create a recurring newsletter format
  • User asks to compile recent developments in a field into a briefing
  • User needs a formatted email-ready content piece with multiple curated items
  • User asks for a "weekly roundup", "monthly digest", or "morning briefing"

Newsletter Workflow

Phase 1: Planning
Step 1.1: Understand Newsletter Requirements

Identify the key parameters:

ParameterDescriptionDefault
Topic(s)Primary subject area(s) to coverRequired
FormatDaily digest, weekly roundup, deep-dive, or industry briefingWeekly roundup
Target AudienceTechnical, executive, general, or niche communityGeneral
ToneProfessional, conversational, witty, or analyticalConversational-professional
LengthShort (5-min read), medium (10-min), long (15-min+)Medium
SectionsNumber and type of content sections4-6 sections
Frequency ContextOne-time or part of a recurring seriesOne-time
Step 1.2: Define Newsletter Structure

Based on the format, select the appropriate structure:

Daily Digest Structure:

1. Top Story (1 item, detailed)
2. Quick Hits (3-5 items, brief)
3. One Stat / Quote of the Day
4. What to Watch

Weekly Roundup Structure:

1. Editor's Note / Intro
2. Top Stories (2-3 items, detailed)
3. Trends & Analysis (1-2 items, original commentary)
4. Quick Bites (4-6 items, brief summaries)
5. Tools & Resources (2-3 items)
6. One More Thing / Closing

Deep-Dive Structure:

1. Introduction & Context
2. Background / Why It Matters
3. Key Developments (detailed analysis)
4. Expert Perspectives
5. What's Next / Implications
6. Further Reading

Industry Briefing Structure:

1. Executive Summary
2. Market Developments
3. Company News & Moves
4. Product & Technology Updates
5. Regulatory & Policy Changes
6. Data & Metrics
7. Outlook
Phase 2: Research & Curation
Step 2.1: Multi-Source Research

Conduct thorough research using web search. The quality of the newsletter depends directly on the quality and recency of research.

Search Strategy:

# Current news and developments
"[topic] news [current month] [current year]"
"[topic] latest developments"
"[topic] announcement this week"

# Trends and analysis
"[topic] trends [current year]"
"[topic] analysis expert opinion"
"[topic] industry report"

# Data and statistics
"[topic] statistics [current year]"
"[topic] market data latest"
"[topic] growth metrics"

# Tools and resources
"[topic] new tools [current year]"
"[topic] open source release"
"best [topic] resources [current year]"

IMPORTANT: Always check <current_date> to ensure search queries use the correct temporal context. Never use hardcoded years.

Step 2.2: Source Evaluation and Selection

Evaluate each source and curate the best content:

CriterionPriority
RecencyPrefer content from the last 7-30 days
AuthorityPrioritize primary sources, official announcements, established publications
UniquenessSelect stories that offer fresh perspective or are underreported
RelevanceEvery item must clearly connect to the newsletter's stated topic(s)
ActionabilityPrefer content readers can act on (tools, insights, strategies)
DiversityMix of news, analysis, data, and practical resources
Step 2.3: Deep Content Extraction

For key stories, use web_fetch to read full articles and extract:

  1. Core facts — What happened, who is involved, when
  2. Context — Why this matters, background information
  3. Data points — Specific numbers, metrics, or statistics
  4. Quotes — Relevant expert quotes or official statements
  5. Implications — What this means for the reader
Phase 3: Writing
Step 3.1: Newsletter Header

Every newsletter starts with a consistent header:

markdown
# [Newsletter Name]

*[Tagline or description] — [Date]*

---

[Optional: One-sentence preview of what's inside]
Step 3.2: Section Writing Guidelines

Top Stories / Featured Items:

  • Headline: Compelling, clear, benefit-oriented (not clickbait)
  • Hook: Opening sentence that makes the reader care (1-2 sentences)
  • Body: Key facts and context (2-4 paragraphs)
  • Why it matters: Connect to the reader's world (1 paragraph)
  • Source link: Always attribute and link to the original source

Quick Bites / Brief Items:

  • Format: Bold headline + 2-3 sentence summary + source link
  • Focus: One key takeaway per item
  • Efficiency: Readers should get the essential insight without clicking through

Analysis / Commentary Sections:

  • Voice: The newsletter's unique perspective on trends or developments
  • Structure: Observation → Context → Implication → (Optional) Actionable takeaway
  • Evidence: Every claim backed by data or sourced information
Show full SKILL.md (522 more words)Show less
Step 3.3: Writing Standards
PrincipleImplementation
ScannableUse headers, bold text, bullet points, and short paragraphs
EngagingLead with the most interesting angle, not chronological order
ConciseEvery sentence earns its place — cut filler ruthlessly
AccurateEvery fact is sourced, every number is verified
AttributiveAlways credit original sources with inline links
HumanWrite like a knowledgeable friend, not a press release

Tone Calibration by Audience:

AudienceToneExample
TechnicalPrecise, no jargon explanations, assumed expertise"The new API supports gRPC streaming with backpressure handling via flow control windows."
ExecutiveImpact-focused, bottom-line, strategic"This acquisition gives Company X a 40% market share in the enterprise segment, directly threatening Incumbent Y's pricing power."
GeneralAccessible, analogies, explains concepts"Think of it like a universal translator for data — it lets any app talk to any database without learning a new language."
Phase 4: Assembly & Polish
Step 4.1: Assemble the Newsletter

Combine all sections into the final document following the chosen structure template.

Every newsletter ends with:

markdown
---

*[Newsletter Name] is [description of what it is].*
*[How to subscribe/share/give feedback]*

*Sources: All links are provided inline. This newsletter curates and summarizes
publicly available information with original commentary.*
Step 4.3: Quality Checklist

Before finalizing, verify:

  • Every factual claim has a source link — No unsourced assertions
  • All links are functional — Verified URLs from search results
  • Date references use the actual current date — No hardcoded or assumed dates
  • Content is current — All major items are from within the expected timeframe
  • No duplicate stories — Each item appears only once
  • Consistent formatting — Headers, bullets, links use the same style throughout
  • Balanced coverage — Not dominated by a single source or perspective
  • Appropriate length — Matches the specified length target
  • Engaging opening — The first 2 sentences make the reader want to continue
  • Clear closing — The newsletter ends with a memorable or actionable note
  • Proofread — No typos, broken formatting, or incomplete sentences

Newsletter Output Template

markdown
# [Newsletter Name]

*[Tagline] — [Full date, e.g., April 4, 2026]*

---

[Preview sentence: "This week: [topic 1], [topic 2], and [topic 3]."]

## 🔥 Top Stories

### [Headline 1]

[Hook — why this matters in 1-2 sentences.]

[Body — 2-4 paragraphs covering key facts, context, and implications.]

**Why it matters:** [1 paragraph connecting to reader's interests or industry impact.]

📎 [Source: Publication Name](URL)

### [Headline 2]

[Same structure as above]

## 📊 Trends & Analysis

### [Trend Title]

[Original commentary on an emerging trend, backed by data from research.]

[Key data points presented clearly — consider inline stats or a brief comparison.]

**The bottom line:** [One-sentence takeaway.]

## ⚡ Quick Bites

- **[Headline]** — [2-3 sentence summary with key takeaway.] [Source](URL)
- **[Headline]** — [2-3 sentence summary.] [Source](URL)
- **[Headline]** — [2-3 sentence summary.] [Source](URL)
- **[Headline]** — [2-3 sentence summary.] [Source](URL)

## 🛠️ Tools & Resources

- **[Tool/Resource Name]** — [What it does and why it's useful.] [Link](URL)
- **[Tool/Resource Name]** — [Description.] [Link](URL)

## 💬 One More Thing

[Closing thought, insightful quote, or forward-looking statement.]

---

*[Newsletter Name] curates the most important [topic] news and analysis.*
*Found this useful? Share it with a colleague.*

*All sources are linked inline. Views and commentary are original.*

Adaptation Examples

Technology Newsletter
  • Emoji usage: ✅ Moderate (section headers)
  • Sections: Top Stories, Deep Dive, Quick Bites, Open Source Spotlight, Dev Tools
  • Tone: Technical-conversational
Business/Finance Newsletter
  • Emoji usage: ❌ Minimal to none
  • Sections: Market Overview, Deal Flow, Company News, Data Corner, Outlook
  • Tone: Professional-analytical
Industry-Specific Newsletter
  • Emoji usage: Moderate
  • Sections: Regulatory Updates, Market Data, Innovation Watch, People Moves, Events
  • Tone: Expert-authoritative
Creative/Marketing Newsletter
  • Emoji usage: ✅ Liberal
  • Sections: Campaign Spotlight, Trend Watch, Viral This Week, Tools We Love, Inspiration
  • Tone: Enthusiastic-professional

Output Handling

After generation:

  • Save the newsletter to /mnt/user-data/outputs/newsletter-{topic}-{date}.md
  • Present the newsletter to the user using the present_files tool
  • Offer to adjust sections, tone, length, or focus areas
  • If the user wants HTML output, note that the Markdown can be converted using standard tools

Notes

  • This skill works best in combination with the deep-research skill for comprehensive topic coverage — load both for newsletters requiring deep analysis
  • Always use <current_date> for temporal context in searches and date references in the newsletter
  • For recurring newsletters, suggest maintaining a consistent structure so readers develop expectations
  • When curating, quality beats quantity — 5 excellent items beat 15 mediocre ones
  • Attribute all content properly — newsletters build trust through transparent sourcing
  • Avoid summarizing paywalled content that the reader cannot access
  • If the user provides specific URLs or articles to include, incorporate them alongside your curated findings
  • The newsletter should provide enough value in the summaries that readers benefit even without clicking through to every link

© bytedance, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/public/newsletter-generation of bytedance/deer-flow.

Open the folder on GitHubat commit 8a3350a

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in bytedance/deer-flow, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Newsletter Generator next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Newsletter Generator compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Newsletter Generator this skillbytedance/deer-flow84k1 repos~3.2kAutomated safety check: PassMIT
News Aggregator Skillcclank/news-aggregator-skill1.3k—~2.1kAutomated safety check: PassNone
Omh Content Operatorrlaope/oh-my-hermes3.2k—~1.9kAutomated safety check: PassMIT
End-of-Article CTA Designersamber/cc-skills227—~3.1kAutomated safety check: PassMIT
Building Communication EngineGTM-Strategist/gtm-strategist-skills264—~2.8kAutomated safety check: PassMIT
Blog WriteAgriciDaniel/claude-blog2.3k1 repos~5.6kAutomated safety check: PassMIT

Similar skills

  • News Aggregator Skill

    cclank/news-aggregator-skill

    Comprehensive news aggregator that fetches, filters, and deeply analyzes real-time content from 44+ sources including Hacker News, Lobsters, Dev.to, GitHub, arXiv, Hugging Face Papers, AIHOT, TLDR…

    1.3k GitHub stars~2.1k tokensUpdated 4 mo ago
    Writing & ContentAuto-check passed
  • Omh Content Operator

    rlaope/oh-my-hermes

    [omh] Product or company copy to publish or rewrite: scope publish-ready writing, rewriting, summarization, translation, release-note, newsletter, customer-copy, social-copy, README-copy, and…

    3.2k GitHub stars~1.9k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Interviews you about objective, audience and context, then designs an end-of-article call to action with copy, placement, A/B test plan and accessibility check.

    227 GitHub stars~3.1k tokensUpdated 10 days ago
    Writing & ContentAuto-check passed
  • Building Communication Engine

    GTM-Strategist/gtm-strategist-skills

    A skill your agent uses when the user wants to choose marketing channels, plan their launch newsletter, set a GTM budget, collect social proof, or build their communication strategy.

    264 GitHub stars~2.8k tokensUpdated 2 mo ago
    Writing & ContentAuto-check passed
  • Blog Write

    AgriciDaniel/claude-blog

    Write new blog articles from scratch optimized for Google rankings and AI citations.

    2.3k GitHub starsUsed in 1 repo~5.6k tokens
    Writing & ContentAuto-check passed
  • Blog Brief

    AgriciDaniel/claude-blog

    Generate detailed content briefs for blog posts with target keywords, content outlines, competitive analysis, recommended statistics, image and chart suggestions, word count targets, internal…

    2.3k GitHub stars~3.2k tokensUpdated 2 days ago
    Writing & ContentAuto-check passed

More from bytedance/deer-flow

All 23 skills in this repo
  • Vercel Deploy

    bytedance/deer-flow

    Deploys a project to Vercel with one script and no login, then returns a live preview URL and a claim link for moving the deployment into your own Vercel account.

    84k GitHub starsUsed in 10 repos~797 tokens
    Auto-check passed
  • GitHub Deep Research

    bytedance/deer-flow

    Researches a GitHub repository over four rounds using the GitHub API and web search, then writes a structured markdown report with timeline, metrics and Mermaid diagrams.

    84k GitHub starsUsed in 4 repos~1.3k tokens
    Auto-check passed
  • Chart Visualization

    bytedance/deer-flow

    Picks a suitable chart type from 26 options for your data, maps the data to that chart's parameters and generates a chart image through a JavaScript script.

    84k GitHub starsUsed in 1 repo~840 tokens
    Auto-check passed
  • Excel and CSV Data Analysis

    bytedance/deer-flow

    Analyzes uploaded Excel and CSV files with SQL through DuckDB, producing schema inspections, statistical summaries and exports to CSV, JSON or Markdown.

    84k GitHub starsUsed in 4 repos~2.2k tokens
    Auto-check passed
  • Structured Image Generation

    bytedance/deer-flow

    Turns an image request into a structured JSON prompt and runs a bundled Python script to generate the picture, optionally guided by reference images.

    84k GitHub starsUsed in 4 repos~2.9k tokens
    Auto-check passed
  • DeerFlow Smoke Test

    bytedance/deer-flow

    Walks through an end-to-end smoke test of a DeerFlow deployment: pull the latest code, deploy with Docker or locally, verify services, run health checks and write a report.

    84k GitHub stars~2.5k tokensUpdated today
    Auto-check: notes

Questions about Newsletter Generator

What does Newsletter Generator do?

Researches a topic and drafts a ready-to-send newsletter in Markdown, such as a weekly roundup, daily digest or industry briefing, with curated links and commentary. The agent starts by pinning down a short list of parameters: the topics, the format (daily digest, weekly roundup, deep-dive or industry briefing, with weekly roundup as the default), the audience, the tone, the length (about a 5, 10 or 15-minute read) and the number of sections, which defaults to four to six. It also asks whether this is a one-off or part of a recurring series that needs consistent structure and branding.

When should I use Newsletter Generator?

Newsletter Generator fits situations like: drafting a weekly roundup of news in a specific industry; turning a pile of recent links on one topic into a curated digest; setting up a repeatable format for a recurring newsletter series.

How do I install Newsletter Generator in Claude Code?

Run `npx skills add bytedance/deer-flow --skill newsletter-generation -a claude-code`. Or copy the skill folder (skills/public/newsletter-generation in bytedance/deer-flow) into .claude/skills/newsletter-generation in your project. Claude Code loads it when a task matches its description.

How do I install Newsletter Generator in Codex?

Run `npx skills add bytedance/deer-flow --skill newsletter-generation -a codex`. Or copy the skill folder (skills/public/newsletter-generation in bytedance/deer-flow) into .agents/skills/newsletter-generation in your project. Codex loads it when a task matches its description.

Can I use Newsletter Generator in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add bytedance/deer-flow --skill newsletter-generation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/newsletter-generation, .gemini/skills/newsletter-generation, .github/skills/newsletter-generation and .opencode/skills/newsletter-generation in your project.

What does Newsletter Generator need to run?

SKILL.md names no scripts, command-line tools or credentials: Newsletter Generator is instructions for the agent only. Our summary lists: Web search access to gather current sources.

Does Newsletter Generator access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Newsletter Generator safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Newsletter Generator use?

Newsletter Generator is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Newsletter Generator use?

About 3.2k tokens (SKILL.md is roughly 13k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Newsletter Generator?

Skills that share tags, products or a category with Newsletter Generator: News Aggregator Skill (cclank/news-aggregator-skill, 1.3k stars), Omh Content Operator (rlaope/oh-my-hermes, 3.2k stars), End-of-Article CTA Designer (samber/cc-skills, 227 stars) and Building Communication Engine (GTM-Strategist/gtm-strategist-skills, 264 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Newsletter Generator?

bytedance (a GitHub organization) maintains it in bytedance/deer-flow, which has 83,674 GitHub stars. The repository holds 23 skills in this directory. The repository was last updated on October 11, 2026.

Source: bytedance/deer-flow on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.