Newsletter Generator

Generate automated email newsletters with curated content, affiliate links, and personalized recommendations. Use when creating daily/weekly newsletters, building email lists, or monetizing subscriber engagement with affiliate content.

Security Scan

The skill's README and feature list promise affiliate integration, analytics, scheduling, and RSS fetching, but the shipped code is limited, contains mocked data, and several referenced scripts/features are missing — this mismatch is suspicious and should be resolved before trusting the skill.

Purpose & Capability

The name/description promise curated content, affiliate integration, analytics, scheduling, and personalization. The bundled code only provides two Python scripts that generate newsletters from hard-coded mock data and write local files. There are no implementations for affiliate network APIs, analytics ingestion, ESP integration, or real RSS fetching. Several capabilities documented in SKILL.md (add_affiliate_links.py, schedule_newsletter.py, analytics_report.py) are referenced but not present. Requiring no credentials while advertising integrations that normally need API keys (ESP, affiliate networks, analytics) is inconsistent.

Instruction Scope

SKILL.md instructs the agent to run various scripts and to curate from RSS feeds / add affiliate links / schedule newsletters. The curate script accepts rss URLs but uses MOCK_RSS_DATA and does not perform network requests or real RSS parsing. SKILL.md references scripts that are not in the bundle. The instructions therefore over-promise and give the agent discretion to perform operations that the included code does not implement — this is confusing and could lead to incorrect assumptions about what will actually happen at runtime.

Install Mechanism

No install specification and the skill is primarily instruction + small Python scripts. Nothing is downloaded from external URLs and no install operations write code to the system. This is low-risk from an install/mechanism perspective.

Credentials

The skill declares no required environment variables or credentials, yet SKILL.md describes integration with affiliate networks, ESPs, and analytics (which typically require API keys/tokens). The absence of declared env vars is inconsistent with the claimed features. If the skill were extended to contact affiliate/ESP APIs it would need credentials — the current manifest does not request them or document how secrets would be used.

Persistence & Privilege

The skill does not request always:true and has no install hooks or code that modifies other skills or system-wide settings. It appears to run only as invoked and writes outputs locally (markdown/JSON files). No elevated persistence is requested.

What to consider before installing

This skill's documentation promises many integrations (RSS crawling, affiliate networks, analytics, scheduling) but the shipped code only generates newsletters from hard-coded mock data and writes local files; several scripts mentioned in the README are missing. Before installing or using it in production: 1) Ask the author for the missing scripts and a clear explanation of which external services the skill will contact and what credentials it needs. 2) Inspect any additional code that will perform network I/O or require API keys — ensure it only uses minimal, service-specific credentials and does not exfiltrate sensitive data. 3) Test the skill in a sandbox (no real credentials) to confirm actual behavior. 4) If you need affiliate/ESP integration, require the skill to explicitly declare the needed environment variables and document how tokens are stored/used. Given the current mismatch between claims and code, do not assume it performs the advertised integrations until the author provides complete, auditable code.

Overview

Automate email newsletter creation with curated content, affiliate monetization, and personalized recommendations. Build and monetize email lists at scale.

Core Capabilities

1. Content Curation

Automatically:

• Curate trending articles and blog posts
• Find relevant content based on keywords/topics
• Extract key points and summaries
• Categorize content by topic (tech, marketing, lifestyle, etc.)
• Filter for quality and relevance

2. Newsletter Templates

Pre-built templates for:

• Daily digest (5-10 links, brief summaries)
• Weekly roundup (deep dives, featured articles)
• Industry news (news-focused, time-sensitive)
• Tutorial series (educational, step-by-step)
• Product recommendations (affiliate-heavy, monetized)

3. Affiliate Integration

Automatically includes:

• Context-aware affiliate links
• Product recommendations matching newsletter theme
• FTC-compliant disclosures
• Trackable links for analytics
• Revenue optimization based on engagement

4. Personalization

Personalize with:

• Subscriber segments
• Past engagement data
• Time zones for optimal send times
• Custom sender info
• Dynamic content based on preferences

5. Analytics & Optimization

Track and optimize:

• Open rates and click-through rates
• Affiliate link performance
• Subscriber growth and churn
• Best-performing content types
• Send time optimization

Quick Start

Generate Daily Digest

# Use scripts/generate_newsletter.py
python3 scripts/generate_newsletter.py \
  --type daily \
  --topic marketing \
  --articles 10 \
  --affiliate-links 3 \
  --output newsletter.md

Generate Weekly Roundup

python3 scripts/generate_newsletter.py \
  --type weekly \
  --topic tech \
  --articles 20 \
  --include-tutorials \
  --include-products \
  --output weekly.md

Curate from RSS Feeds

# Use scripts/curate_content.py
python3 scripts/curate_content.py \
  --rss-feeds https://feeds.feedburner.com/example1,https://example2.com/feed \
  --keywords marketing,seo,content \
  --articles 10 \
  --output curated_content.json

Scripts

generate_newsletter.py

Generate newsletter from curated content.

Parameters:

• --type: Newsletter type (daily, weekly, monthly, roundup, products)
• --topic: Primary topic/theme
• --articles: Number of articles to include
• --affiliate-links: Number of affiliate links to include
• --include-tutorials: Include educational content
• --include-products: Include product recommendations
• --tone: Newsletter tone (professional, casual, playful)
• --output: Output file

Example:

python3 scripts/generate_newsletter.py \
  --type daily \
  --topic digital-marketing \
  --articles 8 \
  --affiliate-links 3 \
  --tone conversational \
  --output newsletter.md

curate_content.py

Curate content from RSS feeds or URLs.

Parameters:

• --rss-feeds: Comma-separated RSS feed URLs
• --keywords: Filter by keywords
• --max-articles: Maximum articles to curate
• --min-relevance: Minimum relevance score (0-1)
• --output: Output JSON file

Example:

python3 scripts/curate_content.py \
  --rss-feeds https://blog.example.com/feed,https://news.example.com/rss \
  --keywords "marketing,seo,growth" \
  --max-articles 15 \
  --output curated.json

add_affiliate_links.py

Add affiliate links to existing newsletter.

Parameters:

• --input: Newsletter file
• --network: Affiliate network (amazon, shareasale, cj, impact)
• --links: Number of links to add
• --disclosure-position: Where to add disclosure (top, bottom, inline)

Example:

python3 scripts/add_affiliate_links.py \
  --input newsletter.md \
  --network amazon \
  --links 5 \
  --disclosure-position top

schedule_newsletter.py

Schedule newsletter for sending (generates schedule data).

Parameters:

• --newsletter: Newsletter file
• --send-time: Optimal send time
• --timezone: Subscriber timezone
• --segments: Subscriber segments
• --output: Schedule file for ESP (Email Service Provider)

Example:

python3 scripts/schedule_newsletter.py \
  --newsletter newsletter.md \
  --send-time "09:00" \
  --timezone "America/Chicago" \
  --output schedule.json

analytics_report.py

Generate analytics and optimization recommendations.

Parameters:

• --metrics-file: Metrics data from ESP
• --period: Time period (7d, 30d, 90d)
• --output: Report file

Newsletter Templates

Daily Digest Template

Subject: [Topic] Daily Digest - [Date]

---

## Today's Top Stories

[Article 1 Title]
[Summary]
[Read more →] [Affiliate Link if applicable]

[Article 2 Title]
[Summary]
[Read more →]

...

## Quick Tip
[Brief actionable tip with affiliate link]

## Featured Resource
[Product/Tool recommendation]
[Brief description]
[Get it here →] [Affiliate Link]

---

[FTC Disclosure]

Weekly Roundup Template

Subject: [Topic] Weekly Roundup - Top [N] Stories

---

## This Week's Highlights

[Deep Dive Article 1]
[Comprehensive summary]
[Read the full article →]

[Deep Dive Article 2]
[Comprehensive summary]
[Read the full article →]

## Tutorial Corner
[Step-by-step tutorial]
[Product recommendations with affiliate links]

## Industry News
[3-5 key news stories]
[Brief updates]

## Recommended Resources
[Product recommendations with affiliate links]

---

[FTC Disclosure]

Best Practices

Subject Lines

• Keep under 50 characters for mobile
• Use numbers and brackets [Daily Digest], [Weekly]
• Include urgency or curiosity
• A/B test different subject lines

Content Balance

• 70% value (educational content)
• 20% curation (other people's content)
• 10% promotion (affiliate/sales)

Affiliate Links

• 1-3 links per newsletter
• Contextually relevant to content
• Clear disclosure at the top
• Trackable links for analytics

Send Times

• B2B: Tuesday-Thursday, 9-11 AM
• B2C: Weekends, 6-8 PM
• Newsletters: Tuesday/Wednesday, 8-10 AM
• Promotions: Monday or Friday

Automation

Daily Newsletter Generation

# Generate daily newsletter at 8 AM
0 8 * * * /path/to/newsletter-generator/scripts/generate_newsletter.py \
  --type daily \
  --topic tech \
  --articles 10 \
  --affiliate-links 3 \
  --output /path/to/newsletters/daily_$(date +\%Y\%m\%d).md

Weekly Roundup

# Generate weekly newsletter every Sunday at 9 AM
0 9 * * 0 /path/to/newsletter-generator/scripts/generate_newsletter.py \
  --type weekly \
  --topic marketing \
  --articles 20 \
  --include-tutorials \
  --output /path/to/newsletters/weekly_$(date +\%Y\%m\%d).md

Integration Opportunities

With Content Recycler

# 1. Recycle article to newsletter format
content-recycler/scripts/recycle_content.py \
  --input article.md \
  --platforms email

# 2. Add affiliate links
newsletter-generator/scripts/add_affiliate_links.py \
  --input email_version.md

With SEO Article Generator

# 1. Generate SEO article
seo-article-gen --keyword "newsletter topic"

# 2. Curate related content
newsletter-generator/scripts/curate_content.py --keywords "newsletter topic"

# 3. Generate newsletter
newsletter-generator/scripts/generate_newsletter.py

Revenue Impact

Email Marketing Stats:

• Average open rate: 20-30%
• Average CTR: 2-5%
• Affiliate conversion: 1-3%
• Revenue per 1,000 subscribers: $50-500/month

Scaling Potential:

• 1 newsletter/day × 1,000 subscribers = $50-500/day
• 1 newsletter/week × 10,000 subscribers = $500-5,000/week

---

Build your list. Monetize automatically. Scale effortlessly.