Email and Inbox skill 06 of 13
Newsletter and Subscription Clean-Up SKILL.md
The Newsletter Clean-Up skill makes Claude, Codex or another AI agent clear bulk mail from your inbox safely. It finds every bulk sender with counts and the last time you opened one, groups them, proposes keep, read later, reduce, unsubscribe or report as spam, acts only on batches you approve, archives old mail, filters what stays and sets a habit that stops the pile returning.
newsletter-cleanup/SKILL.md, version 1.0.0, 1,503 words.
By Afeez Adebayo, Marketing, SEO & Growth Expert with 10+ years of experience.
Created 10 October 2026. Updated 10 October 2026. Free to use under CC BY 4.0.
For many people, half or more of daily email is bulk mail: newsletters they once wanted, promotions from every shop they bought from, product updates, event invitations and social notifications. Each one takes seconds, but together they bury real messages and pull attention dozens of times a day. Large mailbox providers have pushed senders to make leaving easier: since 2024, Gmail and Yahoo have required bulk senders to support one-click unsubscribe. [Confirmed, Gmail and Yahoo sender requirements 2024]
This skill cleans up subscriptions safely: it finds every bulk sender, groups them, helps the user keep, digest or leave each one, unsubscribes only from legitimate senders, marks spam instead of unsubscribing from suspicious ones, filters what stays and sets a habit that stops the pile returning.
Operating principles
- Keep what is read. If the user has not opened a sender in months, it goes.
- Unsubscribe from legitimate senders only. For spam, report it rather than clicking unsubscribe links, which can confirm the address is active.
- Approval before action. The agent proposes; the user confirms each batch.
- Digest what stays. Wanted newsletters go to a Read later label, not the main inbox.
- Prevent the return. New sign-ups use a rule, a separate address or a quick decision at arrival.
Decisions for each sender
| Decision | When | Action |
|---|---|---|
| Keep in inbox | Rare, essential (bank statements, school notices) | No change |
| Keep, read later | Valued newsletters read weekly | Filter to Read later |
| Reduce | Useful but too frequent | Change frequency in sender's preferences |
| Unsubscribe | Not read or not wanted | Use the sender's unsubscribe option |
| Report as spam | Never subscribed, suspicious or ignores unsubscribes | Mark as spam; do not click links |
When to use, and when not to
Use it when bulk mail floods the inbox, after an email audit, at the start of a year, before connecting an AI agent to email, or when moving to a new address.
Don't use it to judge whether a specific message is a phishing attempt (email-security) or to manage work notifications from tools (inbox-rules-filters).
Inputs
- Access to the mailbox, or a list of bulk senders.
- Senders the user definitely wants to keep.
- Whether the user prefers a separate address for shopping and sign-ups.
- Any receipts or records that must still arrive.
Raw SKILL.md file
This is the exact file agents read, including the credit header and licence notice. Save it as newsletter-cleanup/SKILL.md.
--- name: newsletter-cleanup description: "Clean up email subscriptions safely: find bulk senders with counts and last-opened dates, group them, decide keep, read later, reduce, unsubscribe or report as spam, act in approved batches using one-click unsubscribe, bulk archive, filter what stays and set a prevention habit with a two-week check. Use whenever someone wants to unsubscribe from newsletters, reduce promotional email, clean up bulk mail, stop marketing emails or prepare an inbox for an AI email assistant." license: CC-BY-4.0 metadata: author: Afeez Adebayo author_url: https://afeezadebayo.com author_linkedin: https://www.linkedin.com/in/afeez-adebayo/ author_x: https://x.com/za_icon source: https://afeezadebayo.com/skills-md/productivity/email-inbox/newsletter-cleanup/ category: productivity subcategory: email-inbox version: "1.0.0" created: "2026-10-10" updated: "2026-10-13" --- # Newsletter and Subscription Clean-Up For many people, half or more of daily email is bulk mail: newsletters they once wanted, promotions from every shop they bought from, product updates, event invitations and social notifications. Each one takes seconds, but together they bury real messages and pull attention dozens of times a day. Large mailbox providers have pushed senders to make leaving easier: since 2024, Gmail and Yahoo have required bulk senders to support one-click unsubscribe. [Confirmed, Gmail and Yahoo sender requirements 2024] This skill cleans up subscriptions safely: it finds every bulk sender, groups them, helps the user keep, digest or leave each one, unsubscribes only from legitimate senders, marks spam instead of unsubscribing from suspicious ones, filters what stays and sets a habit that stops the pile returning. ## Operating principles 1. **Keep what is read.** If the user has not opened a sender in months, it goes. 2. **Unsubscribe from legitimate senders only.** For spam, report it rather than clicking unsubscribe links, which can confirm the address is active. 3. **Approval before action.** The agent proposes; the user confirms each batch. 4. **Digest what stays.** Wanted newsletters go to a Read later label, not the main inbox. 5. **Prevent the return.** New sign-ups use a rule, a separate address or a quick decision at arrival. ## Decisions for each sender | Decision | When | Action | |---|---|---| | Keep in inbox | Rare, essential (bank statements, school notices) | No change | | Keep, read later | Valued newsletters read weekly | Filter to Read later | | Reduce | Useful but too frequent | Change frequency in sender's preferences | | Unsubscribe | Not read or not wanted | Use the sender's unsubscribe option | | Report as spam | Never subscribed, suspicious or ignores unsubscribes | Mark as spam; do not click links | ## When to use, and when not to Use it when bulk mail floods the inbox, after an email audit, at the start of a year, before connecting an AI agent to email, or when moving to a new address. Don't use it to judge whether a specific message is a phishing attempt (`email-security`) or to manage work notifications from tools (`inbox-rules-filters`). ## Inputs - Access to the mailbox, or a list of bulk senders. - Senders the user definitely wants to keep. - Whether the user prefers a separate address for shopping and sign-ups. - Any receipts or records that must still arrive. ## Workflow ### Step 1. Find bulk senders Search the last 60 to 90 days for messages with an unsubscribe link or List-Unsubscribe header, grouped by sender, with counts and the last date the user opened one. ### Step 2. Group Newsletters, shops and promotions, product updates, social notifications, events, unknown senders. ### Step 3. Propose decisions Default: unsubscribe from senders not opened in 90 days; keep and filter senders opened regularly; report unknown or suspicious senders as spam. ### Step 4. Confirm in batches Show batches of 10 to 20 senders with the proposed action; the user ticks or changes each. ### Step 5. Act Use one-click unsubscribe where the mail client offers it; otherwise the sender's own preference page. Never enter passwords on unsubscribe pages. Apply spam reports and filters. ### Step 6. Bulk archive Archive old messages from removed senders in one action. ### Step 7. Set the prevention habit Decide at arrival for any new bulk sender: keep, filter or leave. Consider a separate address for shopping and sign-ups. ### Step 8. Check after two weeks Senders that keep mailing after unsubscribing get a filter to archive or are reported as spam. ## Batch review template ``` | Sender | Type | Emails (90 days) | Last opened | Proposed | Your decision | | Shop A promotions | Shop | 64 | Never | Unsubscribe | | | Industry weekly | Newsletter | 12 | Last week | Read later | | | Unknown deals | Unknown | 30 | Never | Report spam | | ``` ## Safe unsubscribe rules - Prefer the mail client's built-in unsubscribe button, which uses the sender's list header. - Use links only from known, legitimate senders. - Never log in, enter card details or download anything to unsubscribe. - For unknown or suspicious senders, report as spam instead. - Some legal and account messages cannot be unsubscribed; filter them instead. ## Output format ``` 1. Bulk senders found (count, types, volume) 2. Batches with proposed decisions 3. Actions taken after approval 4. Filters created for kept senders 5. Prevention plan 6. Two-week check date ``` ## A separate address for sign-ups Many people use a second address, or an alias such as name+shops@ where the provider supports it, for shopping, trials and event sign-ups. Mail to that address can be filtered away from the main inbox automatically, and if one service leaks or sells the address, it is easy to see which and stop it. ## Weekly reading slot Newsletters that stay are read in one weekly slot, for example Friday lunchtime, from the Read later label. Anything unread for a month is a signal to unsubscribe. An agent can also summarise the week's newsletters into a short digest with links. ## Measuring the result | Measure | Before | After | |---|---|---| | Bulk emails a day in the main inbox | | | | Bulk senders | | | | Time spent on bulk mail a day | | | Record the numbers before starting and two weeks later; the difference usually makes the habit easy to keep. ## Privacy and data Unsubscribing stops marketing but may not delete the data a company holds. Where privacy law gives the user rights, such as under UK or EU data protection rules, they can ask a company to delete their data; the agent can draft that request for the user to send. Keep any such requests and replies in a folder in case follow-up is needed. ## Agent permissions The agent needs read access to find bulk senders and the ability to apply labels or filters. Unsubscribing and spam reports happen only after the user approves each batch, and the agent never visits unsubscribe pages that ask for a login or payment details. ## Repeat yearly Run the full clean-up once a year, because new subscriptions creep back in through purchases, events and trials. ## Edge cases and judgement calls | Situation | What to do | |---|---| | Thousands of senders | Start with the top 50 by volume | | Work newsletters the user must receive | Filter to Read later instead of leaving | | Account emails mixed with marketing | Change marketing preferences in the account; keep service mail | | Shared family or team address | Agree decisions with the other users | | Sender ignores unsubscribe | Filter to archive or report as spam | ## Handoffs to related skills - Find the volume first: `email-system-audit` - Filters for what stays: `inbox-rules-filters` - Suspicious senders: `email-security` - Daily triage after clean-up: `inbox-triage` ## Worked example A teacher's inbox received about 90 bulk emails a day. The scan found 212 bulk senders in 90 days. In four batches, the teacher kept 9 newsletters (filtered to Read later), reduced 6 shops to monthly emails, unsubscribed from 151 senders and reported 18 unknown senders as spam. Old messages from removed senders were archived in one action. Two weeks later, 4 senders were still emailing and got archive filters. Daily bulk mail fell to about 15 messages. ## Common mistakes - Clicking unsubscribe links in spam. - Unsubscribing from everything, then missing important service mail. - Leaving wanted newsletters in the main inbox. - No prevention habit, so the pile returns. - Acting without the user's approval. ## Self-check before you answer - Was each batch approved before action? - Were suspicious senders reported rather than unsubscribed? - Do kept newsletters skip the main inbox? - Is there a prevention habit and a two-week check? --- Created by Afeez Adebayo, Marketing, SEO & Growth Expert Website: https://afeezadebayo.com LinkedIn: https://www.linkedin.com/in/afeez-adebayo/ X: https://x.com/za_icon Source: https://afeezadebayo.com/skills-md/productivity/email-inbox/newsletter-cleanup/ Licence: CC BY 4.0 (https://creativecommons.org/licenses/by/4.0/). You may copy, share and adapt this skill, including for commercial use, as long as you credit Afeez Adebayo and link to the source URL above. Keep this notice in any copy or adapted version.
Workflow
Step 1. Find bulk senders
Search the last 60 to 90 days for messages with an unsubscribe link or List-Unsubscribe header, grouped by sender, with counts and the last date the user opened one.
Step 2. Group
Newsletters, shops and promotions, product updates, social notifications, events, unknown senders.
Step 3. Propose decisions
Default: unsubscribe from senders not opened in 90 days; keep and filter senders opened regularly; report unknown or suspicious senders as spam.
Step 4. Confirm in batches
Show batches of 10 to 20 senders with the proposed action; the user ticks or changes each.
Step 5. Act
Use one-click unsubscribe where the mail client offers it; otherwise the sender's own preference page. Never enter passwords on unsubscribe pages. Apply spam reports and filters.
Step 6. Bulk archive
Archive old messages from removed senders in one action.
Step 7. Set the prevention habit
Decide at arrival for any new bulk sender: keep, filter or leave. Consider a separate address for shopping and sign-ups.
Step 8. Check after two weeks
Senders that keep mailing after unsubscribing get a filter to archive or are reported as spam.
Batch review template
| Sender | Type | Emails (90 days) | Last opened | Proposed | Your decision |
| Shop A promotions | Shop | 64 | Never | Unsubscribe | |
| Industry weekly | Newsletter | 12 | Last week | Read later | |
| Unknown deals | Unknown | 30 | Never | Report spam | |Safe unsubscribe rules
- Prefer the mail client's built-in unsubscribe button, which uses the sender's list header.
- Use links only from known, legitimate senders.
- Never log in, enter card details or download anything to unsubscribe.
- For unknown or suspicious senders, report as spam instead.
- Some legal and account messages cannot be unsubscribed; filter them instead.
Output format
1. Bulk senders found (count, types, volume)
2. Batches with proposed decisions
3. Actions taken after approval
4. Filters created for kept senders
5. Prevention plan
6. Two-week check dateA separate address for sign-ups
Many people use a second address, or an alias such as name+shops@ where the provider supports it, for shopping, trials and event sign-ups. Mail to that address can be filtered away from the main inbox automatically, and if one service leaks or sells the address, it is easy to see which and stop it.
Weekly reading slot
Newsletters that stay are read in one weekly slot, for example Friday lunchtime, from the Read later label. Anything unread for a month is a signal to unsubscribe. An agent can also summarise the week's newsletters into a short digest with links.
Measuring the result
| Measure | Before | After |
|---|---|---|
| Bulk emails a day in the main inbox | ||
| Bulk senders | ||
| Time spent on bulk mail a day |
Record the numbers before starting and two weeks later; the difference usually makes the habit easy to keep.
Privacy and data
Unsubscribing stops marketing but may not delete the data a company holds. Where privacy law gives the user rights, such as under UK or EU data protection rules, they can ask a company to delete their data; the agent can draft that request for the user to send. Keep any such requests and replies in a folder in case follow-up is needed.
Agent permissions
The agent needs read access to find bulk senders and the ability to apply labels or filters. Unsubscribing and spam reports happen only after the user approves each batch, and the agent never visits unsubscribe pages that ask for a login or payment details.
Repeat yearly
Run the full clean-up once a year, because new subscriptions creep back in through purchases, events and trials.
Edge cases and judgement calls
| Situation | What to do |
|---|---|
| Thousands of senders | Start with the top 50 by volume |
| Work newsletters the user must receive | Filter to Read later instead of leaving |
| Account emails mixed with marketing | Change marketing preferences in the account; keep service mail |
| Shared family or team address | Agree decisions with the other users |
| Sender ignores unsubscribe | Filter to archive or report as spam |
Handoffs to related skills
- Find the volume first:
email-system-audit - Filters for what stays:
inbox-rules-filters - Suspicious senders:
email-security - Daily triage after clean-up:
inbox-triage
Worked example
A teacher's inbox received about 90 bulk emails a day. The scan found 212 bulk senders in 90 days. In four batches, the teacher kept 9 newsletters (filtered to Read later), reduced 6 shops to monthly emails, unsubscribed from 151 senders and reported 18 unknown senders as spam. Old messages from removed senders were archived in one action. Two weeks later, 4 senders were still emailing and got archive filters. Daily bulk mail fell to about 15 messages.
Common mistakes
- Clicking unsubscribe links in spam.
- Unsubscribing from everything, then missing important service mail.
- Leaving wanted newsletters in the main inbox.
- No prevention habit, so the pile returns.
- Acting without the user's approval.
Self-check before you answer
- Was each batch approved before action?
- Were suspicious senders reported rather than unsubscribed?
- Do kept newsletters skip the main inbox?
- Is there a prevention habit and a two-week check?
On this page
- When to use this skill, and when not to
- Example prompts
- Example output
- What the agent needs from you
- How this skill hands off to related skills
- How to run Newsletter Clean-Up step by step
- Situations this skill handles
- What makes this skill different
- Practical tips from real projects
- Frequently asked questions
- Changelog
When to use this skill, and when not to
Use it when newsletters and promotions flood your inbox, after an email audit, at the start of a year, before connecting an AI assistant or when moving to a new address.
Bulk mail often makes up half or more of daily email. Since 2024, Gmail and Yahoo have required bulk senders to support one-click unsubscribe, which makes leaving easier for legitimate senders.
Don’t use it to judge phishing; see Email Security.
Example prompts
- “Clean up my newsletters and promotions.”
- “Show me bulk senders I never open.”
- “Unsubscribe me from everything I have not read in three months.”
- “Keep my favourite newsletters but out of my inbox.”
- “Set up a separate address for shopping sign-ups.”
Example output
The skill returns a fixed structure. A shortened example for an imaginary site:
Bulk senders (90 days): 212 Batch 1 of 4: 20 senders, proposed actions ready Approved: kept 9 (Read later), reduced 6, unsubscribed 151, reported 18 as spam Archived: old mail from removed senders Check on: 27 Oct for senders still emailing Result: bulk mail down from about 90 to 15 a day
The agent proposes and you approve each batch; suspicious senders are reported as spam instead of clicking their unsubscribe links.
What the agent needs from you
The skill asks for mailbox access or a list of bulk senders, the senders you definitely want to keep, whether you want a separate address for sign-ups and any receipts or records that must still arrive.
How this skill hands off to related skills
Newsletter Clean-Up connects to the Email System Audit, Inbox Rules and Filters, Inbox Triage and Email Security.
How to run Newsletter Clean-Up step by step
- Install the skill as
newsletter-cleanup/SKILL.md. - List senders to keep.
- Review batches of proposed actions.
- Approve unsubscribes and spam reports.
- Filter kept newsletters to Read later.
- Check again after two weeks.
Situations this skill handles
Clean-ups vary. The skill handles these:
| Situation | What the skill does |
|---|---|
| Thousands of senders | Top 50 first |
| Required work newsletters | Filtered, not removed |
| Account and marketing mixed | Preferences changed |
| Shared address | Decisions agreed |
| Sender ignores unsubscribe | Filtered or reported |
| Privacy concerns | Deletion request drafted |
What makes this skill different
Most unsubscribe tools click everything for you. This skill shows evidence for each sender, waits for your approval, reports suspicious senders instead of engaging with them, and keeps the newsletters you value in a weekly reading slot.
A prevention habit and a two-week check stop the clutter from returning.
Practical tips from real projects
- Keep what is read.
- Unsubscribe from legitimate senders only.
- Approval before action.
- Prevent the return.
A worked example: a teacher received about 90 bulk emails a day. The scan found 212 bulk senders in 90 days. In four batches the teacher kept 9 newsletters filtered to Read later, reduced 6 shops to monthly emails, unsubscribed from 151 senders and reported 18 unknown senders as spam. Old messages from removed senders were archived in one action, and two weeks later four senders still emailing got archive filters. Daily bulk mail fell to about 15 messages.
Each sender gets one of five decisions: keep in the inbox for rare, essential mail such as bank statements or school notices, keep and read later for valued newsletters, reduce frequency in the sender's preferences, unsubscribe, or report as spam when the user never subscribed or the sender looks suspicious.
The workflow finds bulk senders over 60 to 90 days, groups them into newsletters, shops, product updates, social notifications, events and unknown senders, proposes defaults, confirms in batches of 10 to 20, acts using the mail client's unsubscribe button or the sender's preference page, archives old messages and sets a prevention habit.
Safe unsubscribe rules matter. The agent prefers the mail client's built-in unsubscribe button, uses links only from known senders, never logs in, enters card details or downloads anything to unsubscribe, and reports unknown senders as spam instead. Some legal and account messages cannot be unsubscribed and are filtered instead.
Prevention keeps the inbox clean: a decision at arrival for every new bulk sender, a separate address or alias for shopping and sign-ups that can be filtered automatically, and a weekly reading slot for kept newsletters, with anything unread for a month unsubscribed. An agent can also summarise the week's newsletters into a short digest with links.
Results are measured before and two weeks after: bulk emails a day in the main inbox, number of bulk senders and time spent on bulk mail. Unsubscribing stops marketing but may not delete data, so where data protection law gives rights, the agent can draft a deletion request for the user to send. The full clean-up is repeated once a year, because new subscriptions creep back in through purchases, events and trials.
The agent needs only read access to find bulk senders and the ability to apply labels or filters. Unsubscribing and spam reports happen after the user approves each batch, and the agent never visits unsubscribe pages that ask for a login or payment details. With thousands of senders, the clean-up starts with the top 50 by volume, which usually removes most of the noise in one sitting. Work newsletters the user must receive are filtered to Read later rather than removed, and account emails mixed with marketing are handled by changing marketing preferences inside the account while keeping service messages. On shared family or team addresses, decisions are agreed with the other users before anything is changed, and senders who ignore unsubscribe requests are filtered to archive or reported as spam.
Most people are surprised by how many senders they never read; seeing the counts and last-opened dates makes decisions quick and confident.
Frequently asked questions
Is it safe to click unsubscribe links?
For legitimate senders, yes, ideally through the mail client's unsubscribe button. For spam, report it instead, because clicking can confirm your address is active.
How do I decide what to keep?
Keep senders you open regularly and filter them to a Read later label; leave senders you have not opened in about 90 days.
What is one-click unsubscribe?
A standard that lets mail clients unsubscribe you directly; Gmail and Yahoo have required it from bulk senders since 2024.
What if a sender keeps emailing after I unsubscribe?
Filter it to archive or report it as spam.
Does unsubscribing delete my data?
Not always; where data protection law applies, you can ask the company to delete your data.
How do I stop newsletters coming back?
Decide at arrival, use a separate address or alias for sign-ups and repeat the clean-up yearly.
Changelog
- 1.0.0, 10 October 2026: first release.
Use, adapt and share this skill under CC BY 4.0: credit Afeez Adebayo and link to this page.
