Email Deliverability
Free skill for Claude Code · MIT licence
Free skill on GitHub Premium pack, $15, on Agensi
Email Deliverability is a skill for Claude Code that builds and checks SPF, DKIM, and DMARC records for a domain, using live DNS lookups. An AI agent writing email authentication records from memory gets them wrong in the same ways, every time. This skill teaches the agent the hard rules that keep a record correct: live DNS only, the lookup budget, alignment, and the safe rollout from monitoring to enforcement. The provider lookup costs come from live measurement, not from memory.
A free SPF and DMARC generator already exists on this site: the SPF and DMARC Generator builds both records in the browser, with a live lookup counter. This skill complements it. The tool builds the records, and the skill teaches Claude Code to build, check, and roll them out.
Who it is for
Developers, sysadmins, and marketers who set up email for a domain, and anyone whose mail lands in spam or whose domain can be spoofed because the records were never set up right.
The problem
- It trusts a pasted record that is old or from a different domain, and judges a setup that does not exist.
- It adds one provider too many, and the SPF record goes over the 10-lookup limit and fails outright at receivers.
- It writes a DMARC record with no
ruaaddress, so nobody ever sees what fails. - It jumps straight to
p=reject, and legitimate mail starts bouncing on day one. - It uses
+allor the retired tagspct,rf, andri, and the record is broken or out of date. - It declares a record correct while SPF passes and DMARC still fails, because alignment was never checked.
What is in the free skill
email-deliverability/SKILL.md: the hard rules, how to build SPF and DMARC records, the alignment rules, the rollout stages, a worked example, and a troubleshooting table.email-deliverability/references/provider-includes.md: the 11 measured provider includes with their lookup costs, what each one covers, and the alignment note for each provider.email-deliverability/INSTALL.md: install steps for Claude Code, Codex CLI, Cursor, and Claude.ai.email-deliverability/examples/example-com-records.txt: the worked example, SPF and DMARC records for a domain on Google Workspace and SendGrid.email-deliverability/examples/build-checklist.md: the checklist to run every time a record is built or changed.
Install
git clone https://github.com/WebSmartTools/email-deliverability.git mkdir -p ~/.claude/skills cp -r email-deliverability ~/.claude/skills/
See email-deliverability/INSTALL.md in the repo for Codex CLI, Cursor, and Claude.ai.
How to use it
Ask Claude Code to build or check the SPF, DKIM, and DMARC records for a domain. The skill fetches the live records from DNS, counts the SPF lookups including nested includes, checks alignment, and rolls DMARC out in stages, from monitoring to quarantine to reject, instead of jumping straight to reject.
Premium pack
The premium pack adds three things the free skill does not have, for $15, one-time payment, single-user licence, on Agensi:
check.py: a script that fetches the live SPF, DKIM, and DMARC records for a domain and reports what is wrong. It counts SPF lookups including nested includes, flags+all, over-limit records, and missing records, checks the DMARC policy and retired tags, and checks that a DKIM key record exists for the selector. Python 3, standard library only, no dependencies.references/record-templates.md: ready-to-publish record templates for all 11 providers, each with its SPF include, its DKIM setup, and its alignment note.dmarc-rollout-checklist.md: the full DMARC enforcement rollout checklist, with the monitoring steps and what to check at each stage fromnonetoquarantinetoreject.
The free skill stays free, MIT licensed. The premium pack has its own single-user licence and is not open source.
Questions
Which AI tools does it work with?
The skill is written for Claude Code. The repo's INSTALL.md has the install steps for Codex CLI, Cursor, and Claude.ai.
Is the free skill really free?
Yes. The free skill is MIT licensed, free forever. The premium pack is $15, one-time payment, single-user licence, and it is not open source.