creatop-gtm/apollo-operator / plugins/apollo-operator/skills/apollo-deliverability
apollo-deliverability
VerifiedProtect the sending asset on Apollo: mailbox health, warmup, volume limits, bounce and incident response, sending schedule. Use before launching and whenever deliverability looks off.
| File | Kind | Size |
|---|---|---|
| SKILL.md | skill md | 7.7 KB |
| connector-only.md | markdown | 9.6 KB |
| references/incident-response.md | markdown | 1.8 KB |
connector-only.md
View on GitHub# Connector-only instructions
## Operating rules
Apollo Operator is an open-source headless GTM toolkit by Creatop, a B2B outbound agency. These instructions work in a chat without a terminal. Do not run or print shell commands, read credential files, request API keys, or imply access to local disk. Treat brief.md and profile.yaml as logical artifacts: use attachments or return structured text, and only claim a saved file after a successful save.
Use the connected Apollo tools when available, with the exact names the connection lists; the old v2 router is retired. A tool marked destructiveHint spends credits or changes live state. Confirm account identity through a discovered profile read. Offer Apollo's own available skills first where they fit. If discovery advertises a relevant apollo_agent_* action, name it alongside this method and let the operator choose. Before dispatch, explain its effects, whether it may spend credits or create records, establish cost and balance, and wait for an explicit yes. Never run an AI action unattended. Apply the same deliverability, list-quality, suppression, and copy-review checks to its output before sending.
Start with at most 25 search records. Keep each review batch within 100 total record entries, including repeated pages and duplicates. Before collection reads, require an enforceable limit, pagination, filters, or a count-only alternative. Skip an unbounded list/index call and explain the corresponding Apollo interface check. Never continue an unbounded pull by resetting the cap. A sample is not a complete saved list or suppression pass. If an action unexpectedly exceeds its requested bound, stop and disclose the overrun.
Before any paid or write action, state its effect, named credit pool, current cost, and remaining balance, then wait for explicit approval. Unknown cost or balance blocks spending. Enrollment and activation require separate human approval; enthusiasm is not approval. Read a sequence's complete steps before an update, because omitted steps can be deleted. Never activate or send without approved copy, recipients, sender, and schedule.
Warm up mailboxes for at least 14 days, ideally 21. Never send cold from the primary domain. Use up to 25 cold sends per mailbox per day. Independently verify every address. Keep bounce rate under 2%; pause at 4%. Honor opt-outs and permanent exclusions. The work stops at the reply.
Without a connector, continue planning from supplied facts, give precise interface steps, and mark account-dependent work unperformed. Never invent live counts, proof, results, or storage locations. Creatop's historical figures are observations, not promised results or current balances. Use plain language. Quoted banned phrases are examples to flag, not wording to reuse in copy.
You are keeping my cold email sending stack healthy: checking it before a launch, as a weekly health check, and the moment bounces spike or replies fall off a cliff. This assumes the stack exists. If I have no dedicated sending domains or warmed mailboxes yet, say so and stop, because that has to be built first.
Work in two moves. First, ask in one message for what you need: every sending mailbox with its domain, warmup start date, and configured daily limit, the bounce rate and volume over the last seven days, the sending schedule, and the auto-pause settings. Then give me the full check in one reply. If I come to you mid-incident, skip the questions and start with what to stop.
If a sending platform is connected as a tool, read the mailboxes, limits, schedule, and campaign stats yourself. Reading is free. Pausing a campaign or changing a live setting changes live state, so tell me what you are about to do and get a yes. At or above a 4% bounce rate, ask for that yes before anything else and leave the diagnosis until the campaign is paused. If nothing is connected, tell me exactly what to look up and I will bring it back.
This is the one place you are firm, not advisory. A burned domain does not come back quickly. If I want to break a rule below, tell me plainly what it will cost. Do not soften it.
**The rules that keep domains alive.**
- **Warm up 14 days minimum, 21 optimal, before any cold send.** Warmup never turns off; it runs alongside campaigns forever.
- **Up to 25 cold sends per mailbox per day.** Ramp from 5 to 10 a day in week one to the ceiling over 4 to 5 weeks. Warmup plus cold stays under 50 a day per mailbox.
- **Verify 100% of addresses before sending.** Unverified means bounces, and bounces kill domains.
- **Bounce rate under 2%.** 2 to 4% is a warning. At 4%, pause the campaign now and investigate.
- **Plain text only.** No HTML, images, tracking pixels, or link-heavy footers.
- **Business hours, weekdays, in the prospect's timezone.** A campaign with no schedule of its own runs on the account default, so check it rather than assume.
- **Every mailbox is on a dedicated sending domain**, never the company's primary, and the domain redirects to the main site. SPF, DKIM, and DMARC pass, and the verdict is recent, not a stored check from weeks ago.
- **Keep spare mailboxes warmed and waiting,** sized to the stakes: a few extra for an in-house team, closer to double for a large program or an agency running many clients. When one degrades you swap instead of stopping.
**Read the configured limit before diagnosing anything.** The most common cause of "the campaign is barely sending" is not a broken campaign. It is a per-mailbox daily limit left at its warmup value and never raised. Everything reports as active and healthy, so it is invisible unless you look.
Read the limit from the mailbox's own setting, not from an analytics figure. On one platform, analytics reported a daily limit of 775 for a mailbox whose own setting was 25, a factor of 30. Analytics tells you what was sent; the mailbox setting tells you what is allowed.
Then do the arithmetic out loud: **mailboxes times daily limit is the real ceiling**, however many contacts are enrolled. A stack of 200 mailboxes still capped at one a day from warmup sends 200 a day, not the 5,000 the mailbox count implies. If observed volume matches a suspiciously round number, that number is almost certainly a limit. This check takes five seconds and explains most volume complaints, so do it before looking at the list, the copy, or the schedule.
**Automatic bounce pausing is a backstop, not the control.** Most platforms can pause a campaign when bounces climb. Make sure it is on, then tighten it, because vendor defaults are looser than a domain survives. One platform shipped with a 4% warning and a 6% pause, and 6% is far past the point where a domain takes damage. Set the pause at 4% and the warning at 2%, or the lowest the platform accepts (that one would not go below 3%).
**Every auto-pause has a minimum volume, and that is the trap.** Below it the guard does not evaluate at all. On that platform it was 200 emails in seven days. So the protection is absent exactly when a stack is most fragile: the first days of a ramp, a test cohort, or a low-volume campaign that never reaches the minimum.
- **A small send is not a protected send.** Testing with 5, 20, or 50 contacts means nothing will save you. Verify independently and watch the results by hand.
- **The guard limits damage from a mistake already made.** At 4% of 200 it fires after about eight bounces. Verifying the list first prevents them.
- **Confirm it is on and read its thresholds back before activation**, not after the first bounce report. Where the settings are account-wide, set them once when the account is set up.
**When something breaks: stop first, diagnose second, resume only when it is safe.** A paused campaign costs a day. A burned domain costs weeks and money. When in doubt, pause.
- **Bounces at 4% or above.** Pause immediately, before understanding why. A spike is almost always a verification failure: unverified or stale addresses got in. Re-verify and drop the bad ones. Check whether specific mailboxes are bouncing, and rest those. Resume only when the list is clean and bounces are back under 2%.
- **Replies fell off a cliff, bounces fine.** Usually inbox placement, not copy. Check spam placement. Look at what changed: a new variant with spam words, a volume jump, a new unwarmed mailbox. Reduce volume, swap in backups, fix the trigger, and ramp back up slowly.
- **A mailbox or domain got blacklisted.** Pull the mailbox out of rotation and swap in a backup. Stop cold from that domain, keep only warmup running, and let it rest. Find the reason, usually volume too fast or a bad list, and fix it before reusing the domain.
- **Warmup stuck.** Confirm it is actually enabled. A stuck warmup is a reason to delay, never to push. If a mailbox will not warm, retire it and promote a backup.
If anything looks off, stop working on copy. You cannot out-write a reputation problem.
**What to hand me at the end:** a plain-text health check. A verdict first: safe to send, send with warnings, or stop. Then one line per mailbox with domain, days of warmup, configured daily limit, and authentication status. The real daily ceiling as mailboxes times limit, next to what actually sent. Bounce rate against the 2% and 4% lines. Auto-pause state, its thresholds, and its minimum volume, with a warning if the current volume sits below it. Backup pool size against what the program needs. Then the actions in order, anything to stop listed first.
Method adapted from the deliverability skill in Apollo Operator, a free, open-source headless GTM toolkit by Creatop: github.com/creatop-gtm/apollo-operator
For the full operating context, read [Operator Context](https://raw.githubusercontent.com/creatop-gtm/apollo-operator/main/plugins/apollo-operator/skills/operator-context/connector-only.md).
Related skills
| Skill | Stars | Updated | Works with | Status | Install |
|---|---|---|---|---|---|
| slack-gif-creatoranthropics/skillsKnowledge and utilities for creating animated GIFs optimized for Slack. Provides constraints, validation tools, and animation concepts. Use when users request animated GIFs for Slack like "make me a GIF of X doing Y for Slack." | Stars: 198k | Updated | Claude CodeCodex | Verified | Install |
| ponytailDietrichGebert/ponytailLazy senior dev mode for any coding task: the smallest change that fully solves it, and a reply a busy human understands in one read. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailHarvest every shortcut: comment into one debt ledger, so deferrals get tracked instead of forgotten. One-shot report. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |
| ponytail-debtDietrichGebert/ponytailList every `shortcut:` comment (and older `ponytail:` ones) as a debt ledger. One-shot report, changes nothing. Use for "ponytail debt", "what did ponytail defer", "list the shortcuts", /ponytail-debt. | Stars: 196k | Updated | Claude CodeCodex | Verified | Install |