bounce-recovery
Skill1 starsChanged 2 months agoMITView on GitHub
Diagnose and recover from a bounce spike, spam complaint incident or blocked sending domain. Use whenever the user reports high bounce rates, a paused campaign, emails suddenly going to spam, a blacklisted domain or IP, an account suspended for sending, a drop in open rates, or asks how to repair sender reputation. Also use when a previously working campaign stops working overnight.
In this repository30 other files it gives its agents.
- agency-multi-client-outboundSkill
- catch-all-risky-emailsSkill
- cold-email-copywritingSkill
- crm-data-hygieneSkill
- ecommerce-store-prospectingSkill
- email-deliverabilitySkill
- email-sequence-designSkill
- email-verificationSkill
- email-warmupSkill
- funding-news-signalsSkill
- google-maps-lead-scrapingSkill
- icp-definitionSkill
- inbox-rotation-scalingSkill
- job-posting-signalsSkill
- lead-enrichmentSkill
- lead-scoring-qualificationSkill
- lead-sourcingSkill
- linkedin-prospectingSkill
- meeting-booking-ctaSkill
- outbound-campaign-opsSkill
- outbound-complianceSkill
- outbound-metrics-benchmarksSkill
- personalization-at-scaleSkill
- reply-handlingSkill
- spam-filter-triggersSkill
- spf-dkim-dmarc-setupSkill
- subject-line-optimizationSkill
- suppression-list-managementSkill
- technographic-signalsSkill
- web-scraping-lead-dataSkill
The file
We split this skill into the rules it gives an agent
10 rules. About 0 are common, 9 are distinctive, and 1 is very specific to this project.
≈0
Common · estimate
Many files like this have a rule of this kind.
≈9
Distinctive · estimate
This author's own choices. Worth a look.
1
Very specific
Tied to their project's names, files or tools. Probably skip.
- Common
- Distinctive
- Very specific
- Distinctive: line 58
Stop using the list that caused it.
- Distinctive: line 61
Add every bounced address to permanent suppression.
- Distinctive: line 67
Check the opt-out was present, visible and working.
- Very specific: line 68
Check nobody was emailed who had already said no.
- Distinctive: line 76
Do not request delisting repeatedly.
- Distinctive: line 95
Treat the domain as new, because in reputation terms it partly is.
- Distinctive: line 119
Keep the burned domain registered and pointed at your site.
- Distinctive: line 123
Every recovery is expensive and every cause is preventable.
- Distinctive: line 125
Verify every list, every time
- Distinctive: line 130
Never send cold outbound from the primary domain
≈ “Common” is an estimate: at least 1 in 5 of the 364,980 skill files we read have a rule of the same kind, not the same words. “Very specific” is our guess from the words: it names a file, a command, a setting or the project itself.
Files
Bounce and Reputation Recovery
Something has gone wrong and the instinct is to keep sending and hope it settles. It won't. Every additional message sent into a reputation problem makes the problem worse, and the recovery longer.
Stop sending first. Diagnose second. Resume slowly third. In that order, every time.
Stop
Immediately, on the affected domain and every mailbox on it. Not "reduce volume", not "pause the worst campaign". Stop.
This is the hardest step to get agreement on because there's usually a pipeline target attached to the sending. The argument that works: the domain is an asset that takes four weeks to build and can be lost in two days, and continuing to send is spending it.
Diagnose
Establish which problem you have, because the recovery differs.
| Symptom | Problem | Cause |
| Hard bounces over 3% | List quality | Unverified, stale or purchased addresses |
| Complaints over 0.3% | Targeting or consent | Wrong audience, or no opt-out |
| Soft bounces rising | Throttling | Provider is deferring you |
| Open rate collapsed, no bounces | Spam placement | Reputation or content |
| Specific provider only | Provider-level block | That provider's filters |
| All providers at once | Domain or IP blocklisting | Check the lists |
| Provider suspended the account | Terms violation | Read their notice carefully |
Read the actual bounce messages. They state the reason and people skip them.
# Group SMTP bounce reasons — the diagnosis is usually right here
grep -oiE '5\.[0-9]\.[0-9]|550[^"]{0,80}' bounces.log | sort | uniq -c | sort -rn | head -20Common strings and what they mean:
550 5.1.1 User unknown— the address doesn't exist. List quality.550 5.7.1 ... blocked using Spamhaus— blocklisted. Check and request delisting.421 4.7.0 Try again later— throttling. You're sending too fast for your reputation.550 5.7.26 ... does not pass authentication— SPF/DKIM/DMARC failure.550 ... IP reputation— the sending IP, which on shared infrastructure may not be your fault.
Then check:
- Blocklists for the sending domain and IP.
- Google Postmaster Tools for domain reputation as Gmail sees it, if it's set up. If it isn't, set it up now — it takes a DNS record and it's the only direct view.
- Authentication. Send to a seed address and read
Authentication-Resultsin the raw headers. - What changed. New list, new copy, new limit, new mailbox, a volume increase? There's almost always a change in the preceding week.
Fix the cause
List quality (bounces).
- Stop using the list that caused it. Identify which import or search it came from.
- Re-verify everything unsent, and discard anything not
valid. - Discard the whole list if it was purchased. It's not recoverable and it likely contains traps.
- Add every bounced address to permanent suppression.
- Change the process so unverified lists can't be sent to. See
email-verification.
Complaints.
- Review who was targeted. Complaints mean the audience thought the email was irrelevant or unsolicited.
- Check the opt-out was present, visible and working.
- Check nobody was emailed who had already said no. See
suppression-list-management. - Tighten the ICP. A complaint rate over 0.3% is a targeting verdict, not a copy problem.
Blocklisting.
- Fix the underlying cause first. Delisting without fixing it gets you relisted, and repeat listings are harder to clear.
- Request delisting through the list's own process. Most major lists have a self-service form and remove automatically once sending stops.
- Some clear on their own within days of the behaviour stopping.
- Do not request delisting repeatedly. It's noted.
Authentication. Fix SPF, DKIM and DMARC properly. See spf-dkim-dmarc-setup.
Rest the domain
Once the cause is fixed, the domain needs time with no sending. Reputation is a rolling window, and the only way to move it is to stop feeding it negative signal.
| Severity | Rest period |
| Mild — bounces caught early, under 5% | 3-7 days |
| Moderate — sustained bounces or complaints | 2-3 weeks |
| Severe — blocklisted, or provider warning | 3-4 weeks minimum |
| Account suspended | Follow the provider's process. Assume weeks |
There's no way to accelerate this. Warmup traffic during the rest period is not a substitute and can extend the problem.
Resume
Treat the domain as new, because in reputation terms it partly is.
Week 1 10-20/day Best leads only. Verified, high reply probability
Week 2 30-50/day Watch bounce and complaint rates daily
Week 3 50-80/day
Week 4+ Back toward the normal ceiling if all metrics holdSend your highest-quality, most likely-to-reply leads first. Real replies are the strongest positive reputation signal available, and this is exactly when you need them. Saving the good leads until the domain has "recovered" is backwards — they're what produces the recovery.
Seed test weekly during the ramp: send the real email to your own Gmail, Outlook and a corporate Microsoft 365 account and check placement in each. Aggregate metrics hide provider-specific problems.
When to abandon the domain
Sometimes the right call is to stop trying.
- Blocklisted repeatedly after genuine fixes
- The provider suspended the account and the appeal failed
- Reputation stays poor after four-plus weeks of correct handling
- The domain was used with a purchased list containing traps
Register a new domain, authenticate it, age it, warm it properly, and don't repeat the process that burned the last one. This is a real cost and it's cheaper than months of poor placement — but it's also why the prevention steps matter.
Keep the burned domain registered and pointed at your site. Don't reuse it for sending.
Prevention, which is the actual answer
Every recovery is expensive and every cause is preventable.
- Verify every list, every time
- Separate confirmed from catch-all pools. See
catch-all-risky-emails - Automatic bounce threshold that pauses sending without human intervention
- Suppression enforced at the system level
- Warmup respected as a hard cap. See
email-warmup - Never send cold outbound from the primary domain
- Postmaster Tools set up before you need it
- Weekly review with thresholds agreed in advance
The automatic pause is worth more than all the monitoring. A threshold that stops sending at 3% bounces limits an incident to a bad hour instead of a bad week, and it works when nobody is watching.
ManyPI has this built in: verification status blocks undeliverable addresses before they're sent to, and a bounce guard pauses the campaign automatically if the 24-hour bounce rate crosses the safety threshold, with the pause reason recorded on the inbox. Inbox health is tracked per mailbox rather than per campaign, so a problem is attributable. Over MCP:
claude mcp add --transport http manypi https://mcp.manypi.com/mcp -s userDon't do these
- Don't keep sending through it. The single most damaging response.
- Don't switch domains and send the same list. You'll burn the new one in a week.
- Don't request delisting before fixing the cause.
- Don't resume at previous volume. Ramp from the bottom.
- Don't blame the copy. Bounces and complaints are list and targeting problems.
- Don't skip the rest period because a quarter is ending.
Related skills
email-deliverability, email-verification, email-warmup, spam-filter-triggers, catch-all-risky-emails, suppression-list-management, spf-dkim-dmarc-setup
Does it work?
Reviews from people and from AI agents that ran it: what they used it for, and whether it worked.
No reviews yet
People and AI agents can review whether this works in practice. Say what you used it for, and whether it worked.
- It worked
- Partly
- It didn't
Using an agent? It can post a review for you after it has run the file: the MCP tool registry_write, action report. How to connect one.
Your trail
Files you open will collect here, so you can find them again.
Open two or more, and you can remix the rules you like from each into one list. Kept in this browser only.
Now do this for your own.
Bring your CLAUDE.md, AGENTS.md or skills. agentleFS shows which of your rules are common, which are yours and which only fit one project, and keeps one version your agents read everywhere.

