ai-architect-newsletter

AI Architect Newsletter

Purpose

Automated intelligence newsletter generation for AI Architects, combining latest AI news, FrankX research hub insights, and visual storytelling into production-ready HTML/text newsletters.

When to Use

/ai-architect-newsletter - Generate weekly newsletter
/ai-architect-newsletter daily - Quick daily brief
/ai-architect-newsletter [topic] - Deep dive on specific topic
/ai-architect-newsletter status - Review recent newsletters

Quick Start

Generate Weekly Newsletter

# Basic invocation (uses Opus 4.8 recommended)
/ai-architect-newsletter

# The system will:
# 1. Gather latest AI news (WebSearch)
# 2. Pull relevant research from /research hub
# 3. Generate visual newsletter (HTML + text)
# 4. Save to content/newsletters/YYYY-MM-DD-newsletter.html
# 5. Display summary with preview link

Newsletter Structure

1. Header Section

Custom header image (AI Architect theme)
Issue number, date, edition type
Editor's note with Frank's perspective

2. Top Stories (5 key developments)

Each story includes:

Headline with impact level
"Why This Matters for AI Architects" analysis
Visual asset (embedded or linked)
Technical details or code examples
Read more link to source

3. Deep Dive Section

One technical deep-dive featuring:

Architecture diagrams
Code examples
Implementation patterns
Production considerations

4. Research Spotlight

Highlight from FrankX research hub:

Recent /research findings
Cross-referenced with news
Actionable insights
Links to full research files

5. Tools Worth Watching

3-4 new tools with:

Quick take (1-2 sentences)
Use case for AI Architects
GitHub/product link
Integration considerations

6. Footer

Newsletter archive link
Social links (X, LinkedIn, GitHub)
Unsubscribe/preferences
Copyright notice

Intelligence Gathering

AI News Sources

See ai-news-sources.md for complete source list including:

Model Releases:

OpenAI, Anthropic, Google DeepMind, Meta AI
Cohere, Mistral, Stability AI, Hugging Face

Research:

arXiv (cs.AI, cs.CL, cs.LG)
Major lab blogs (OpenAI Research, Anthropic Research)
Conference proceedings (NeurIPS, ICML, ACL)

Tools & Frameworks:

GitHub trending (AI/ML repositories)
LangChain, LlamaIndex, CrewAI releases
MCP server ecosystem
Agent frameworks (AutoGPT, BabyAGI updates)

Enterprise AI:

Gartner AI reports
Production AI case studies
MLOps platform updates
AI infrastructure news

Research Hub Integration

The skill automatically scans /research/ directory for:

Recent intelligence briefs (/research command output)
Topic-specific deep dives
Tool evaluations
Pattern discoveries

Cross-references news with research to provide context and depth.

Visual Asset Strategy

AI Lab Logos:

Store in assets/branding/labs/
OpenAI, Anthropic, Google, Meta, etc.
Used for story attribution

Generated Images:

Nano Banana MCP for custom header images
Architecture diagrams via Nano Banana
AI-themed newsletter headers
Concept illustrations for complex topics

Embedding vs Linking:

Embed: Logo badges, small icons (<50KB)
Link: Header images, diagrams, screenshots
Optimization: All images compressed for email clients

Newsletter Modes

Weekly Newsletter (Default)

Trigger: /ai-architect-newsletter

Output:

5-7 top stories
1 deep dive (1500-2000 words)
Research spotlight
Tools section
~15-20 min read time

Recommended Model: Opus 4.8 (deep synthesis)

Daily Brief

Trigger: /ai-architect-newsletter daily

Output:

Top 3 stories
Quick takes (100-150 words each)
Notable tools (1-2)
~5 min read time

Recommended Model: Sonnet 4.6 (faster)

Topic Deep Dive

Trigger: /ai-architect-newsletter [topic]

Examples:

/ai-architect-newsletter agentic systems
/ai-architect-newsletter vision models
/ai-architect-newsletter production RAG

Output:

Focused on single topic
Multi-source synthesis
Code examples and patterns
Architecture recommendations

Recommended Model: Opus 4.8 (depth)

Status Check

Trigger: /ai-architect-newsletter status

Output:

List recent newsletters
Performance stats (if tracking enabled)
Scheduled newsletters
Archive links

Scripts Reference

gather-ai-news.ts

Purpose: Automated news gathering via WebSearch

Usage:

// Called automatically during newsletter generation
// Or manually: npx tsx scripts/gather-ai-news.ts --mode weekly

Output: JSON file with structured news data Location: .claude/skills/ai-architect-newsletter/cache/news-YYYY-MM-DD.json

See script for configuration options.

process-research.ts

Purpose: Scan and index FrankX research hub

Usage:

// Scans /research/ directory for relevant content
// Indexes by topic, date, relevance

Output: Research index JSON Cross-reference: Matches news topics with research findings

generate-newsletter.ts

Purpose: Template engine for HTML/text output

Usage:

// Processes gathered data into newsletter format
// Applies templates, injects content, optimizes assets

Templates Used:

assets/templates/newsletter.html - Main HTML template
assets/templates/newsletter.txt - Plain text version
assets/templates/social-preview.html - Social sharing card

optimize-images.ts

Purpose: Image processing and embedding

Usage:

// Compresses images for email clients
// Converts to base64 for embedding (small images)
// Uploads to CDN and generates links (large images)

Optimization:

Resize for email clients (max 600px width)
Compress JPEG (80% quality)
PNG optimization via pngquant
WebP fallbacks for modern clients

Voice & Style Guidelines

Frank's Newsletter Voice

See content-patterns.md for complete style guide.

Key Principles:

Lead with impact: "Why this matters for AI Architects" first
No hype: Precise technical language, factual analysis
Actionable: Every story includes "What you can do" section
Code over prose: Show implementations, not just concepts
Humble expertise: Confident analysis without guru language

Tone:

Studio energy at 2am (focused, building)
Builder-to-builder communication
Results over philosophy
Specific numbers and examples

Avoid:

Spiritual/guru language
Grandiose claims ("revolutionary", "game-changing")
Over-explaining fundamentals
Marketing copy tone
Emojis (unless data/code context)

Output Locations

FrankX Repository

/mnt/c/Users/Frank/FrankX/
├── content/newsletters/
│   ├── YYYY-MM-DD-weekly.html
│   ├── YYYY-MM-DD-weekly.txt
│   └── archive/
└── public/newsletters/
    └── images/
        └── YYYY-MM-DD/

AI Architect Academy Repository

/mnt/c/Users/Frank/ai-architect-academy/
├── newsletters/
│   ├── YYYY-MM-DD.html
│   └── archive/
└── assets/newsletter-images/

Multi-Repo Support

Repo Detection:

// Automatically detects current repo
const isAcademy = process.cwd().includes('ai-architect-academy');
const outputPath = isAcademy
  ? 'newsletters/'
  : 'content/newsletters/';

Cross-Repo Syncing:

Newsletter generated in FrankX can be copied to Academy
Research hub remains in FrankX only
Academy uses external research links

Progressive Disclosure

This SKILL.md provides core workflow. For detailed information:

ai-news-sources.md - Complete source list, search patterns, RSS feeds
content-patterns.md - Newsletter structures, voice guide, templates

Integration with Existing Commands

Synergy with /research:

# 1. Run research first
/research agentic systems

# 2. Generate newsletter with research integrated
/ai-architect-newsletter

# Research findings automatically included in newsletter

Synergy with /generate-social:

# After newsletter generation
/generate-social content/newsletters/YYYY-MM-DD-weekly.html

# Creates X thread + LinkedIn post from newsletter

Quality Checklist

Before sending newsletter:

All sources verified and linked
Code examples tested
Images optimized (<500KB total)
HTML renders in major email clients
Plain text version readable
Links functional
Unsubscribe link present
Mobile responsive
No broken images
Spell check passed

Model Recommendations

Opus 4.8 (Recommended for quality):

Weekly newsletter generation
Deep dive topics
Multi-source synthesis
Complex architecture diagrams

Sonnet 4.6 (Faster):

Daily briefs
Status checks
Quick updates
Research indexing

When to use each:

First newsletter run: Opus 4.8 (establish quality baseline)
Daily operations: Sonnet 4.6 (speed)
Important editions: Opus 4.8 (quality)
Routine updates: Sonnet 4.6 (efficiency)

Troubleshooting

Newsletter not generating:

Check WebSearch tool availability
Verify /research directory accessible
Ensure write permissions to output directory

Missing images:

Verify Nano Banana MCP connection
Check image optimization script
Ensure sufficient disk space

Research not integrated:

Run /research command first to generate content
Verify research files in /research/ directory
Check file permissions

Multi-repo issues:

Verify current working directory
Check path configurations in scripts
Ensure both repos accessible

Future Enhancements

Automated scheduling (weekly cron)
Email distribution integration (Resend MCP)
Analytics tracking (open rates, clicks)
A/B testing for subject lines
Subscriber segmentation
RSS feed generation
Archive website

Created: 2026-02-16 Status: Production Ready Model: Works with Sonnet 4.6, Opus 4.8 recommended for quality Line Count: 458 (under 500-line rule ✅)

About this skill

Purpose

When to Use

Quick Start

Generate Weekly Newsletter

Newsletter Structure

1. Header Section

2. Top Stories (5 key developments)

3. Deep Dive Section

4. Research Spotlight

5. Tools Worth Watching

6. Footer

Intelligence Gathering

AI News Sources

Research Hub Integration

Visual Asset Strategy

Newsletter Modes

Weekly Newsletter (Default)

Daily Brief

Topic Deep Dive

Status Check

Scripts Reference

gather-ai-news.ts

process-research.ts

generate-newsletter.ts

optimize-images.ts

Voice & Style Guidelines

Frank's Newsletter Voice

Output Locations

FrankX Repository

AI Architect Academy Repository

Multi-Repo Support

Progressive Disclosure

Integration with Existing Commands

Quality Checklist

Model Recommendations

Troubleshooting

Future Enhancements