Agent skill

Spark Recipe Newsletter Cleanup

by readdle in readdle/spark-cli-skills

Audit newsletter subscriptions: block unwanted senders, unsubscribe from mailing lists, and enable AI summaries for worth-keeping ones.

MITAuto-check passedWriting & Content

Install Spark Recipe Newsletter Cleanup

skills CLI
$ npx skills add readdle/spark-cli-skills --skill spark-recipe-newsletter-cleanup -a claude-code

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

GitHub CLI
$ gh skill install readdle/spark-cli-skills spark-recipe-newsletter-cleanup --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/readdle/spark-cli-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/recipe-newsletter-cleanup .claude/skills/spark-recipe-newsletter-cleanup && 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
spark-recipe-newsletter-cleanup
GitHub stars
149
Token cost
~583 tokens
SKILL.md length
227 words
Files
1
Skills in repo
34
Repo updated
First seen
Licence
MIT

At a glance

Audit newsletter subscriptions: block unwanted senders, unsubscribe from mailing lists, and enable AI summaries for worth-keeping ones.

  • Works in 5 steps: List all newsletters → Review individual newsletters → Remove unwanted subscriptions → …
  • Tasks that involve Newsletters
  • SKILL.md covers Steps and Tips
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Spark Recipe Newsletter Cleanup is an agent skill from readdle/spark-cli-skills. Audit newsletter subscriptions: block unwanted senders, unsubscribe from mailing lists, and enable AI summaries for worth-keeping ones.

Its SKILL.md is about 580 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content, covering Newsletters. The licence is MIT.

When your agent uses it

  • Tasks that involve Newsletters

Example prompts

  • “/spark-recipe-newsletter-cleanup”

Workflow steps

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

  1. List all newsletters
  2. Review individual newsletters
  3. Remove unwanted subscriptions
  4. Enable AI summaries for keepers
  5. Group repetitive senders

What it can do on your machine

Read from SKILL.md and the folder at commit cb20383. 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 bash).

    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

Spark Recipe Newsletter Cleanup loads about 583 tokens when it runs. Until then it costs about 42 tokens; SKILL.md has 227 words of instructions outside code blocks.

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

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 readdle/spark-cli-skills at commit cb20383, republished under its MIT licence (© readdle). 227 words, ~583 tokens.

Download SKILL.mdSave it as .claude/skills/spark-recipe-newsletter-cleanup/SKILL.md (or your agent's skills folder).
name
spark-recipe-newsletter-cleanup
description
Audit newsletter subscriptions: block unwanted senders, unsubscribe from mailing lists, and enable AI summaries for worth-keeping ones.
metadata.version
1.0.0

Recipe: Newsletter Cleanup

Audit and prune newsletter subscriptions. Block the unwanted, unsubscribe from the noisy, and enable AI summaries for the ones worth keeping.

Prerequisite: Read the use-spark base skill for command reference and filter syntax.

Access level required: triage.

Steps

Step 1: List all newsletters
bash
spark emails Inbox --filter "category:newsletter"

Review the senders. Look for patterns: senders the user never reads, duplicates, or obsolete subscriptions.

Step 2: Review individual newsletters

For each sender the user wants to evaluate:

bash
spark thread <id>
Step 3: Remove unwanted subscriptions

For mailing lists with an unsubscribe mechanism:

bash
spark action unsubscribe <id>

For senders that should be blocked entirely:

bash
spark contact-action blockContact spammer@example.com

To block an entire domain:

bash
spark contact-action blockDomain example.com
Step 4: Enable AI summaries for keepers

For newsletters the user wants to keep but not read in full:

bash
spark contact-action enableAutosummaryForContact newsletter@example.com
Step 5: Group repetitive senders

For senders that send frequently, group their emails to reduce inbox clutter:

bash
spark contact-action groupEmailsFromContact sender@example.com

Tips

  • Start with spark emails Inbox --filter "category:newsletter" --page-size 50 to see a broad list of senders.
  • Ask the user which senders they actually read before blocking anything.
  • unsubscribe works through the mailing list's unsubscribe mechanism - it's cleaner than blocking.
  • blockContact stops all future mail from appearing; blockDomain is more aggressive.
  • Auto-summary generates a brief AI summary at the top of each email from that sender - great for digests.
  • Grouping (groupEmailsFromContact) collapses repeated messages from the same sender into a single entry.
  • Run this recipe periodically (monthly) to keep the newsletter list pruned.

© readdle, 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/recipe-newsletter-cleanup of readdle/spark-cli-skills.

Open the folder on GitHubat commit cb20383

Compare with similar skills

Spark Recipe Newsletter Cleanup 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.

Spark Recipe Newsletter Cleanup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Spark Recipe Newsletter Cleanup this skillreaddle/spark-cli-skills149—~583Automated safety check: PassMIT
Internal Communications Writeranthropics/skills180k38 repos~378Automated safety check: PassApache-2.0
Clarityaddyosmani/clarity2691 repos~1.9kAutomated safety check: PassMIT
News Aggregator Skillcclank/news-aggregator-skill1.3k—~2.1kAutomated safety check: PassNone
Changelog Social RecapFlorianBruniaux/claude-code-ultimate-guide6.1k—~1.8kAutomated safety check: NotesCC-BY-SA-4.0
Newsletter Voicecharlie947/social-media-skills3.8k—~2.5kAutomated safety check: PassMIT

Similar skills

  • Official

    A set of resources to help me write all kinds of internal communications, using the formats that my company likes to use. Claude should use this skill…

    180k GitHub starsUsed in 38 repos~378 tokens
    Writing & ContentAuto-check passed
  • Clarity

    addyosmani/clarity

    Draft, rewrite, or review reader-facing prose so it is specific, useful, and recognizably the author's without inventing facts or performing humanness.

    269 GitHub starsUsed in 1 repo~1.9k tokens
    Writing & ContentAuto-check passed
  • 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
  • Changelog Social Recap

    FlorianBruniaux/claude-code-ultimate-guide

    Turns CHANGELOG.md entries for a release or a week into LinkedIn, Twitter/X, newsletter and Slack posts in French and English.

    6.1k GitHub stars~1.8k tokensUpdated today
    Writing & ContentAuto-check: notes
  • Newsletter Voice

    charlie947/social-media-skills

    Build newsletter writing instructions inside a Codex or Claude project.

    3.8k GitHub stars~2.5k tokensUpdated 26 days ago
    Writing & ContentAuto-check passed
  • News Extractor

    NanmiCoder/NewsCrawler

    新闻站点内容提取。支持 12 个平台:微信公众号、今日头条、网易新闻、搜狐新闻、腾讯新闻、BBC News、CNN News、Twitter/X、Lenny's Newsletter、Naver Blog、Detik News、Quora。当用户需要提取新闻内容、抓取公众号文章、爬取新闻、或获取新闻JSON/Markdown时激活。

    624 GitHub stars~1.3k tokensUpdated 2 mo ago
    Writing & ContentAuto-check passed

More from readdle/spark-cli-skills

All 34 skills in this repo
  • Spark Persona Exec Assistant

    readdle/spark-cli-skills

    Executive assistant persona for Spark. An agent skill from readdle/spark-cli-skills.

    149 GitHub stars~775 tokensUpdated 4 days ago
    Auto-check passed
  • Spark Persona Founder

    readdle/spark-cli-skills

    Founder / CEO persona for Spark. An agent skill from readdle/spark-cli-skills.

    149 GitHub stars~1.1k tokensUpdated 4 days ago
    Auto-check passed
  • Use Spark

    readdle/spark-cli-skills

    Use the spark CLI to access the user's Spark email data - list emails, search by topic, read threads, check calendar events, find availability, look up contacts, and view team info.

    149 GitHub stars~14k tokensUpdated 4 days ago
    Auto-check: warnings
  • Spark Persona Freelancer

    readdle/spark-cli-skills

    Freelancer / solo operator persona for Spark. An agent skill from readdle/spark-cli-skills.

    149 GitHub stars~1.1k tokensUpdated 4 days ago
    Auto-check passed
  • Spark Persona Meeting Manager

    readdle/spark-cli-skills

    Meeting manager persona for Spark. An agent skill from readdle/spark-cli-skills.

    149 GitHub stars~1.2k tokensUpdated 4 days ago
    Auto-check passed
  • Spark Persona Project Manager

    readdle/spark-cli-skills

    Project manager persona for Spark. An agent skill from readdle/spark-cli-skills.

    149 GitHub stars~1.3k tokensUpdated 4 days ago
    Auto-check passed

Questions about Spark Recipe Newsletter Cleanup

What does Spark Recipe Newsletter Cleanup do?

Audit newsletter subscriptions: block unwanted senders, unsubscribe from mailing lists, and enable AI summaries for worth-keeping ones. Spark Recipe Newsletter Cleanup is an agent skill from readdle/spark-cli-skills. Audit newsletter subscriptions: block unwanted senders, unsubscribe from mailing lists, and enable AI summaries for worth-keeping ones.

When should I use Spark Recipe Newsletter Cleanup?

Spark Recipe Newsletter Cleanup fits situations like: tasks that involve Newsletters.

How do I install Spark Recipe Newsletter Cleanup in Claude Code?

Run `npx skills add readdle/spark-cli-skills --skill spark-recipe-newsletter-cleanup -a claude-code`. Or copy the skill folder (skills/recipe-newsletter-cleanup in readdle/spark-cli-skills) into .claude/skills/spark-recipe-newsletter-cleanup in your project. Claude Code loads it when a task matches its description.

How do I install Spark Recipe Newsletter Cleanup in Codex?

Run `npx skills add readdle/spark-cli-skills --skill spark-recipe-newsletter-cleanup -a codex`. Or copy the skill folder (skills/recipe-newsletter-cleanup in readdle/spark-cli-skills) into .agents/skills/spark-recipe-newsletter-cleanup in your project. Codex loads it when a task matches its description.

Can I use Spark Recipe Newsletter Cleanup 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 readdle/spark-cli-skills --skill spark-recipe-newsletter-cleanup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/spark-recipe-newsletter-cleanup, .gemini/skills/spark-recipe-newsletter-cleanup, .github/skills/spark-recipe-newsletter-cleanup and .opencode/skills/spark-recipe-newsletter-cleanup in your project.

What does Spark Recipe Newsletter Cleanup need to run?

SKILL.md names no scripts, command-line tools or credentials: Spark Recipe Newsletter Cleanup is instructions for the agent only.

Does Spark Recipe Newsletter Cleanup 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 Spark Recipe Newsletter Cleanup 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 Spark Recipe Newsletter Cleanup use?

Spark Recipe Newsletter Cleanup 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 Spark Recipe Newsletter Cleanup use?

About 583 tokens (SKILL.md is roughly 2.3k 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 Spark Recipe Newsletter Cleanup?

Skills that share tags, products or a category with Spark Recipe Newsletter Cleanup: Internal Communications Writer (anthropics/skills, 180k stars), Clarity (addyosmani/clarity, 269 stars), News Aggregator Skill (cclank/news-aggregator-skill, 1.3k stars) and Changelog Social Recap (FlorianBruniaux/claude-code-ultimate-guide, 6.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Spark Recipe Newsletter Cleanup?

readdle (a GitHub organization) maintains it in readdle/spark-cli-skills, which has 149 GitHub stars. The repository holds 34 skills in this directory. The repository was last updated on October 7, 2026.

Source: readdle/spark-cli-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.