Newsletter Digest Builder

Newsletter Digest Builder

This skill takes a folder of saved articles and newsletters (.txt or .md files) and returns a structured weekly digest: articles scored by relevance to your role, grouped by topic, with a "Read This Week" shortlist at the top.

Input:

• A folder path (or list of files) containing .txt/.md articles — one article per file
• Your role or current focus area (stated in 1–2 sentences in your message)

Output:

• Markdown digest with a "Read This Week" shortlist (5–7 items), full list grouped by topic, and a "Can Skip This Week" section

---

Language Detection

Detect the user's language from their message:

• If Russian (or contains Cyrillic): respond in Russian
• If English (or other Latin-script language): respond in English
• If ambiguous: respond in the language of the trigger phrase used

---

Instructions

Step 1: Validate Input

1. Check that files have been provided (folder path, uploaded files, or pasted list)

• If no files provided: stop and return — "Please provide a folder path or upload your saved article files (.txt or .md). I need at least 1 article to build a digest."
• Accepted formats: .txt files, .md files, pasted markdown list

1. Check that the user's role or focus area is stated in their message

• If missing: ask once before proceeding — "What's your current role or focus area? (e.g., 'PM focused on AI product launches' or 'Marketer working on B2B demand generation')"
• Do not guess or assign a generic role — prioritization depends on it

1. Validate files: skip empty or unreadable files; note count at end of output

• If all files are empty or unreadable: stop with — "No readable article files found. Check that files contain article text."

Step 2: Extract Articles

1. For each file, extract:

• Title: first H1 heading, first bold line, or filename (as fallback)
• Source domain: from URLs in the file if present (e.g., hbr.org, lenny.substack.com)
• Body text: first 200–300 words for topic detection and relevance scoring

1. Build a working list: [title, source, body_excerpt] per article

1. Skip binary, code, or non-article files silently; note count at end if any skipped

Edge Cases:

• Files contain only a URL with no body text: extract domain and URL path as title; flag in output "digest based on URL metadata only"
• Very large folder (50+ files): process all; cap shortlist at 7; note total count
• Files in mixed languages (EN + RU): process both; group by topic regardless of language; respond in user's message language

Step 3: Detect Topics

1. Analyze all article titles and body excerpts to identify 3–6 topic clusters

• Use title keywords and source domain signals:
• hbr.org, mckinsey.com → Leadership/Strategy
• lenny.substack.com, svpg.com → Product Management
• nngroup.com, smashingmagazine.com → UX/Design
• techcrunch.com, theverge.com, wired.com → Tech/Industry News
• towardsdatascience.com, arxiv.org → AI/Data
• Marketing/growth newsletters → Growth/Marketing
• For unknown sources: use title keywords to assign topic
• Articles that don't fit any cluster: assign to "General"

1. Aim for 3–6 distinct groups; if folder is small (< 6 files), use 2–3 groups

Edge Cases:

• All articles from a single domain: group by subtopic using title keywords; note "All items from one source — grouped by subtopic"
• Only 1–2 articles total: skip topic grouping; output flat list with labels; note "Too few files for grouping"

Step 4: Score Relevance by Role

1. For each article, score relevance to the user's stated role and focus area:

• [Must Read]: Directly relevant — topic matches stated role/focus, or title addresses a specific problem the user likely faces
• [Useful]: Broadly relevant — adjacent topic, useful background, or industry context
• [Optional]: Low relevance — interesting but tangential to stated role and focus

1. Apply scoring across all articles before ranking

1. Role-specific scoring signals (examples):

• PM / Product Manager: prioritize product strategy, user research, metrics, AI product, B2B SaaS topics
• Marketer / Marketing: prioritize growth, SEO, content strategy, demand gen, social, copywriting topics
• Custom role: score based on keywords in the stated description

1. Within each topic group, sort: Must Read → Useful → Optional

Step 5: Build "Read This Week" Shortlist

Exception — 1–2 articles total: Skip the "Read This Week" shortlist heading entirely. Output a flat list of all articles with relevance labels only. Add note: "Too few files for grouping — showing all items." Go directly to Step 6 with flat-list format (omit shortlist and topic group sections).

1. Select top 5–7 articles overall:

• Prefer [Must Read] items from the widest topic variety (max 2 per topic in shortlist)
• If fewer than 5 [Must Read] items: include top [Useful] items

1. For each shortlisted item, add a 1-sentence relevance note explaining why it's recommended for this role

1. Cap at 7 items regardless of folder size

Step 6: Format and Output

1. Build the output markdown (see Output Format section below)
2. Include all articles from input in the full grouped list — no items silently dropped
3. Add footer with count of skipped files (if any)

---

Negative Cases

• No files provided: Stop — "Please provide a folder path or upload your saved article files (.txt or .md)."
• All files empty: Stop — "No readable content found. Files appear empty or contain no article text."
• Role not provided: Ask once — do not produce output without it (prioritization is meaningless without role context)
• Non-article files only (code, spreadsheets, binary): Stop — "No readable article files found. Expected .txt or .md files with article content."

---

Output Format

## Weekly Digest — [YYYY-MM-DD]
**Role:** [user-stated role and focus]
**Articles processed:** X | **Skipped:** Y (omit if 0)

---

### Read This Week (Top 5–7)
1. **[Title]** — [Topic] · [1-sentence relevance note for this role]
2. **[Title]** — [Topic] · [1-sentence relevance note for this role]
...

---

### Full List by Topic

#### [Topic 1 name]
- [Must Read] **[Title]** — [source domain or filename]
- [Useful] **[Title]** — [source domain or filename]
- [Optional] **[Title]** — [source domain or filename]

#### [Topic 2 name]
...

---

### Can Skip This Week
- [Optional] **[Title]** — [brief reason: low relevance to stated focus]
...

Field rules:

• Relevance labels: always one of [Must Read] / [Useful] / [Optional]
• "Read This Week" items always include a 1-sentence relevance note
• "Can Skip This Week": only [Optional] items; include brief reason if non-obvious
• If all items are [Must Read]: omit "Can Skip This Week" section
• Filename used as title fallback when no title detected in file

Source & license

This open-source skill is cataloged on AgentStack and links to its original source — we do not rehost the code.

• Author: KirKruglov
• Source: KirKruglov/claude-skills-kit
• License: MIT

Install and usage instructions live in the source repository linked above.