Skip to content
cccskills
FreePublished on GitHubEnglish overview

newsletter-generation

Research a topic across multiple web sources and turn selected stories into a newsletter with summaries, commentary, and source links. Adapt the structure and tone for daily digests, weekly roundups, detailed features, or industry briefings.

OriginalShow the original 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".

Works withOutlook

Run score Not tested

See how to install

Good for

  • Create a weekly newsletter on a chosen topic
  • Prepare an industry briefing for executives
  • Summarize recent news for general readers
  • Define a consistent format for a recurring newsletter

Overview

What it does

Research a chosen topic across multiple web sources and turn the findings into a newsletter combining summaries with original commentary. The skill organizes major stories, trend analysis, short news items, tools, and reference material into a Markdown draft with source links. It supports daily digests, weekly roundups, focused deep dives, and industry reports. The tone and level of explanation are adjusted to suit the intended readers.

When it helps

Use it when you regularly share developments in a field or need to organize several articles for an audience. You can choose a structure for an accessible general-interest summary or an executive briefing focused on implications. For recurring newsletters, it keeps the name and heading structure consistent across issues.

Example requests

  • “Turn this week’s technology news into a weekly newsletter for general readers.”
  • “Summarize recent developments in this industry for executives.”
  • “Include these articles and draft a newsletter with a structure I can reuse each month.”

Notes

Research uses web search and web_fetch to retrieve article text. Output is Markdown; converting it to HTML requires a separate conversion tool. The skill follows a policy of avoiding summaries of material that readers cannot access, such as paywalled articles.

This overview was written by AI (OpenAI Codex) from the public SKILL.md. Check the original below for the exact behavior.

Document check

AI checked the SKILL.md for operations that need care and for setup requirements. The score comes only from actually running the skill (hands-on test).

SafetyAre sending data, deleting files, and running commands disclosed?
AGoodOperations cover web search, article retrieval, and drafting; there are no instructions to send emails or delete files.
Easy setupDoes it need few tools or API keys, and are they documented?
BPartly lackingIt uses web search and web_fetch, but provides no instructions for preparing the required environment.

Not counted in the score. Rated by AI (OpenAI Codex) as of Oct 21, 2026. Treat it as a guide and read the original before installing.

Disagree? Request a re-evaluation

Tell us which point is wrong and why. No login needed. We will check it against the SKILL.md, redo the evaluation, and show the result here.

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

Files included (1)

  • SKILL.md12.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

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:

# [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

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.

Step 4.2: Footer

Every newsletter ends with:

---

*[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

# [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

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Turn academic papers into structured reviews that explain findings, strengths, weaknesses, and research methods. Assess originality and supporting evidence, compare relevant literature, and provide specific improvement suggestions in a detailed review or brief summary.

  • Understanding a paper's findings and limitations
  • Preparing a draft peer review
  • Checking experimental design and reproducibility
bytedance/deer-flow84.3KUpdated Oct 23, 2026

Find Python input/output calls that may stall asynchronous backend work, then fix or guard each relevant path with runtime tests. Verify that tests fail when blocking behavior returns and pass after the fix is restored.

  • Checking asynchronous Python changes before a pull request
  • Triaging blocking input/output across the codebase
  • Adding tests for cleanup and error branches
bytedance/deer-flow84.3KUpdated Oct 23, 2026

bootstrap

FreeSummary

Create or update a SOUL.md file that defines an AI partner’s behavior through a guided conversation. Clarify communication style, autonomy, honesty, and expectations, then review a concise English profile before saving it with setup_agent.

  • Define an AI partner’s initial personality and role
  • Adjust tone and how the AI expresses disagreement
  • Clarify which decisions the AI can make independently
bytedance/deer-flow84.3KUpdated Oct 23, 2026

Turn data into chart images by selecting a suitable format from 26 options. Visualize trends, comparisons, distributions, flows, or relationships, then receive the image URL and the complete settings used to generate it.

  • Visualize changes over time
  • Compare categories and proportions
  • Show distributions and correlations
bytedance/deer-flow84.3KUpdated Oct 23, 2026

Send research and analysis tasks to a running DeerFlow instance through its HTTP API, an interface for exchanging requests. Retrieve responses, continue conversations, upload documents, and inspect available models, skills, agents, and service health.

  • Delegate research and analysis to DeerFlow
  • Upload documents for a conversation
  • Resume an earlier conversation
bytedance/deer-flow84.3KUpdated Oct 23, 2026

Turn source code into project documentation, from a README with installation steps and examples to API references, architecture diagrams, developer guides, and changelogs. Match the scope and comment format to the project's size and programming language.

  • Creating a README with installation steps and usage examples
  • Documenting public functions, parameters, and return values
  • Preparing architecture and contributor guides for new developers
bytedance/deer-flow84.3KUpdated Oct 23, 2026

See all skills by bytedance

Report a problem with this skill