deliverability-checker

Name: deliverability-checker
Author: guia-matthieu

github.com/guia-matthieuCloud & DevOps150257 installsUpdated 4w ago

About deliverability-checker

deliverability-checker is a skill for diagnosing email delivery configuration issues. Its command-line scripts check a domain’s SPF, DKIM, DMARC, and MX records and can produce an audit report for troubleshooting or verification.

Key features

01Audit SPF, DKIM, DMARC, and MX
02Check individual DNS record types
03Generate HTML audit reports
04Reference common provider records

Use cases

01Troubleshoot emails landing in spam
02Verify email authentication for new domains
03Audit email settings after domain migration
04Check a client domain’s email health

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/guia-matthieu/clawfu-skills --skill deliverability-checker

After installing, type/deliverability-checkerin Claude Code to confirm it loaded.

Bundled filesscripts/main.pyscripts/requirements.txt

Details

From the project README

Email Deliverability Checker

Diagnose email deliverability issues by checking SPF, DKIM, DMARC, and other DNS records - fix why your emails land in spam.

When to Use This Skill

Delivery troubleshooting - Emails landing in spam
New domain setup - Configure email authentication
Migration audit - Verify email config after domain change
Client onboarding - Check client email health
Compliance check - Ensure proper authentication

What Claude Does vs What You Decide

Claude Does	You Decide
Structures analysis frameworks	Metric definitions
Identifies patterns in data	Business interpretation
Creates visualization templates	Dashboard design
Suggests optimization areas	Action priorities
Calculates statistical measures	Decision thresholds

Dependencies

pip install dnspython click

Commands

Full Audit

python scripts/main.py audit example.com
python scripts/main.py audit example.com --output report.html

Check SPF

python scripts/main.py spf example.com

Check DKIM

python scripts/main.py dkim example.com --selector google
python scripts/main.py dkim example.com --selector default

Check DMARC

python scripts/main.py dmarc example.com

Check MX Records

python scripts/main.py mx example.com

Examples

Example 1: Full Email Audit

python scripts/main.py audit acme-corp.com

# Output:
# Email Deliverability Audit: acme-corp.com
# ──────────────────────────────────────────
# MX Records:      ✓ Found (Google Workspace)
# SPF:             ✓ Valid
# DKIM (google):   ✓ Valid
# DMARC:           ✗ Missing (CRITICAL)
#
# Score: 75/100
#
# Issues Found:
# 1. [CRITICAL] No DMARC record found
#    Fix: Add TXT record for _dmarc.acme-corp.com
#    Value: v=DMARC1; p=none; rua=mailto:[email protected]

Example 2: Diagnose SPF Issues

python scripts/main.py spf newsletter-sender.com

# Output:
# SPF Analysis: newsletter-sender.com
# ────────────────────────────────────
# Record: v=spf1 include:_spf.google.com include:sendgrid.net ~all
#
# Status: ✓ Valid
#
# Authorized Senders:
# - Google Workspace (include:_spf.google.com)
# - SendGrid (include:sendgrid.net)
#
# Policy: ~all (soft fail)
# Warning: Consider changing to -all (hard fail) for better security

Email Authentication Records

Record	Purpose	Location
SPF	Authorize sending servers	`TXT` on root domain
DKIM	Cryptographic signature	`TXT` on `selector._domainkey`
DMARC	Policy and reporting	`TXT` on `_dmarc` subdomain
MX	Mail delivery servers	`MX` on root domain

Common SPF Includes

Provider	SPF Include
Google Workspace	`include:_spf.google.com`
Microsoft 365	`include:spf.protection.outlook.com`
SendGrid	`include:sendgrid.net`
Mailchimp	`include:servers.mcsv.net`
Amazon SES	`include:amazonses.com`

DKIM Selectors by Provider

Provider	Common Selector
Google Workspace	`google`
Microsoft 365	`selector1`, `selector2`
SendGrid	`s1`, `s2`
Mailchimp	`k1`

Deliverability Score Factors

Factor	Weight	Impact
Valid MX	20%	Can't receive replies
Valid SPF	25%	Server authorization
Valid DKIM	25%	Message integrity
Valid DMARC	30%	Policy enforcement

Skill Boundaries

What This Skill Does Well

Structuring data analysis
Identifying patterns and trends
Creating visualization frameworks
Calculating statistical measures

What This Skill Cannot Do

Access your actual data
Replace statistical expertise
Make business decisions
Guarantee prediction accuracy

Related Skills

dns-audit - Full DNS health check

Skill Metadata

Mode: centaur

category: email-tools
subcategory: deliverability
dependencies: [dnspython]
difficulty: beginner
time_saved: 2+ hours/week

Comments

Markdown supported

Details

Author: guia-matthieu
Repository: guia-matthieu/clawfu-skills
Category: Cloud & DevOps
Installs: 257
GitHub stars: 150

Report

More skills

All skills

lark-apps

open.feishu.cn

732.0k

Develop and host Miaoda (Spark/Miaoda) apps: app creation, local full-stack development, cloud generation and iteration, creative design (UI mockups / interactive prototypes / wireframes / landing pages / dashboards / slide decks / visual exploration), integration of AI-related capabilities, Feishu platform capabilities, or other external capabilities; log/Trace/monitoring metric/PV/UV queries; environment variable management; app collaborators and collaboration permissions; app roles and members; and automation triggers (scheduled / record changes / Webhook / Feishu approvals). Use when users want to develop or create a system, tool, platform, or app; develop locally or in the cloud, modify, deploy, publish, launch, or get a shareable link; create a page or website with HTML and deploy it to Miaoda; design, create a mockup, prototype, wireframe, PPT, deck, or visual exploration; or mention Miaoda/Spark/Miaoda apps (links like `/app/app_xxx` or `/page/<token>`, runtime domains like *.aiforce.cloud), app databases, app file storage, open API Keys, visibility, app collaborators/developer permissions, app roles/role members, production logs, API request volume, error volume, latency, traffic, environment variables, or setting up automation tasks, scheduled triggers, or approval-triggered automation for Miaoda apps. Not for regular cloud drive file uploads (lark-drive), Feishu document editing (lark-doc), or native slide creation (lark-slides).

azure-prepare

github.com/microsoft

571.7k

Prepare azd-based Azure projects for deployment: generates azure.yaml, infrastructure (Bicep/Terraform), and Dockerfiles for the Azure Developer CLI (azd) workflow. USE ONLY when the user explicitly wants to use azd as the deployment tool, or the project already has an azure.yaml file. DO NOT USE FOR: non-azd deployments, Python App Service code-only deploys (use python-appservice-deploy), or cross-cloud migration (use azure-cloud-migrate). WHEN: prepare app for azd, create azure.yaml, set up azd infrastructure, modernize app for Azure with azd, deploy with azd, function app, timer trigger, service bus trigger, event-driven function, managed identity, generate Bicep, generate Terraform, create and deploy to Azure.

wizard

github.com/mattpocock

571.5k

Generate an interactive bash wizard that walks a human through steps only they can perform. Use when provisioning infrastructure, setting up credentials or CI secrets, walking an unfamiliar third-party dashboard, or running a one-off migration or cutover. Don't invoke this for steps the agent can perform itself.

azure-ai

github.com/microsoft

571.2k

Use for Azure AI: Search, Speech, OpenAI, Document Intelligence. Helps with search, vector/hybrid search, speech-to-text, text-to-speech, transcription, OCR. WHEN: AI Search, query search, vector search, hybrid search, semantic search, speech-to-text, text-to-speech, transcribe, OCR, convert text to speech.