Senderkit email deliverability
Skill senderkit/senderkit-skills/skills/senderkit-email-deliverability
Add and operate transactional email, SMS, push & web-push from your AI coding agent — no provider lock-in. Skills + MCP for Claude Code, Codex & Cursor.
npx -y skills add senderkit/senderkit-skills --skill senderkit-email-deliverabilityAssembled from the repository path, not quoted from the project. Check it against their README if it does not work.
One thing to look at
- 1 stars1 stars. Stars are a popularity signal and not a quality one, but at this level it is likely that nobody has read this closely except its author, and you would be relying on your own review.
What its author says it does
Copied from the file, not written here
Diagnose and fix email deliverability and domain authentication so transactional email lands in the inbox instead of spam. Use whenever emails go to spam or are not arriving, or a user wants to set up, fix, or verify SPF, DKIM, DMARC, MX, or DMARC alignment, authenticate a sending domain, improve sender reputation, reduce bounces, or check why mail is rejected or filtered. Works whether mail is sent directly via SenderKit or routed through a provider (Resend, SendGrid, Postmark, Mailgun, SES, SMTP). Diagnoses current DNS with standard tools (dig/nslookup), generates the exact records to add, then verifies them. For wiring sends into code use senderkit-integration; for live test sends use senderkit-mcp-messaging-operations.
SKILL.md
5.5 KB, as published. Nobody here has run it
SenderKit email deliverability
Use this open-source skill to get authenticated, inbox-landing transactional email. It diagnoses a sending domain's authentication, generates the exact DNS records to fix it, and verifies the result — using standard tools (dig/nslookup) that need no install, signup, or API key. The reusable source lives at https://github.com/senderkit/senderkit-skills in the skills/senderkit-email-deliverability/ directory; the skill name remains senderkit-email-deliverability.
Email authentication is required whether the app sends directly via SenderKit or routes through a provider (Resend, SendGrid, Postmark, Mailgun, SES, SMTP). This skill is provider-agnostic: it reads and fixes the DNS that controls inbox placement.
This skill does not change application code and does not edit DNS — it inspects DNS, produces records for the user to apply at their DNS host, and re-checks them. To wire sends into the codebase (From domain, headers) use senderkit-integration. To send a live test message and confirm placement use senderkit-mcp-messaging-operations.
Workflow
-
Identify the sending domain.
- Establish the exact
Fromdomain mail is (or will be) sent from, e.g.mail.example.comorexample.com. - If known, note the SenderKit DKIM selector and SPF include for the account; otherwise the user obtains these from the SenderKit dashboard (see step 4). Do not guess these values.
- Establish the exact
-
Diagnose current DNS. Read
references/spf-dkim-dmarc.mdfor syntax and limits, then query:- SPF:
dig +short TXT <domain>— flag a missing record, more than onev=spf1record, syntax errors, and the 10-DNS-lookup limit. - DKIM:
dig +short TXT <selector>._domainkey.<domain>— confirm the selector is published with ap=public key. - DMARC:
dig +short TXT _dmarc.<domain>— confirm presence and policy strength (p=nonevsquarantine/reject) and reporting (rua). - MX:
dig +short MX <domain>— sanity check. - Alignment: confirm SPF (
MAIL FROM/Return-Path) and DKIM (d=) align with the visibleFromdomain.
- SPF:
-
Generate the records to add.
- Produce the exact TXT records for the diagnosed faults (one consolidated SPF record; DKIM as published by SenderKit; a DMARC record starting at
p=nonefor monitoring, then escalating). - Never produce a second
v=spf1record; merge includes into the existing one.
- Produce the exact TXT records for the diagnosed faults (one consolidated SPF record; DKIM as published by SenderKit; a DMARC record starting at
-
SenderKit handoff for issued values.
- DKIM key/selector and the domain-verification token are issued when a sending domain is registered with SenderKit. There is no MCP tool for this yet — direct the user to the SenderKit dashboard/docs to copy the exact DKIM record and verification token, then add them alongside the records from step 3.
- If a future SenderKit domain-management tool/endpoint is available at runtime, use it here to fetch the records instead of asking the user to copy them.
-
Verify.
- Re-run the
digqueries from step 2 to confirm publication. Set expectations: DNS propagation is eventually-consistent (minutes to hours); offer a re-check rather than asserting instant success. - Optionally suggest a manual validator (mail-tester.com, Google Postmaster Tools, MXToolbox) — these are optional and require no key.
- Optionally use
senderkit-mcp-messaging-operationsto send a live test and confirm inbox placement and that headers pass SPF/DKIM/DMARC.
- Re-run the
-
Code-side follow-ups (optional, defer depth to
senderkit-integration).- Ensure the app
Fromdomain matches the authenticated domain. - Ensure
List-UnsubscribeandList-Unsubscribe-Postheaders are present on bulk-ish transactional mail. - For deeper code changes, hand off to
senderkit-integration.
- Ensure the app
When a symptom is reported ("going to spam", "not arriving", "bouncing"), read references/troubleshooting.md and map symptom → cause → fix before changing records.
Reference files
references/spf-dkim-dmarc.md- SPF/DKIM/DMARC concepts, record syntax, the 10-lookup limit, alignment, and a BIMI note.references/dns-provider-notes.md- Where and how to add TXT records on common DNS hosts.references/troubleshooting.md- Symptom → likely cause → fix for spam folder, bounces, and non-delivery.references/sources.md- Source notes used to build this skill.
Standards
- Diagnose before prescribing: never tell a user to add a record without first reading what is published.
- Keep exactly one SPF record per domain; stay within 10 DNS lookups.
- Recommend DMARC starting at
p=nonewithruareporting, then escalating toquarantine/rejectafter monitoring. - Do not fabricate SenderKit DKIM selectors, SPF includes, or verification tokens; use the values SenderKit issues.
- Treat current SenderKit docs/dashboard as source of truth over this skill's static notes.