Skip to content
cccskills
FreePublished on GitHub

email-quality-auditor

Review an email program before release using 20 SEND criteria. Checks authentication, consent, unsubscribe handling, claims, engagement, and outcome evidence, then reports a release verdict, required fixes, or specific gaps that prevent scoring.

OriginalShow the original description

Use when the user asks to "audit an email program" or "is this campaign safe to send"; runs a typed 20-item SEND profile with authentication, consent, opt-out, and claim veto checks on own evidence. Not for building deliverability setup — use deliverability-qa; not for designing lifecycle flows — use email-sequence-designer. 邮件质量审计/EQS评分/发送前放行

Run score Not tested

See how to install

Good for

  • Auditing a newsletter before release
  • Checking consent and unsubscribe handling
  • Reviewing authentication and promotional claims
  • Assessing engagement with privacy-related open-rate limits

Files included (2)

  • SKILL.md8.2 KB
  • references/auditor-runtime.md14.6 KB

SKILL.md (original)

Review the instructions the agent will receive before you install.

Email Quality Auditor

Audit one email program/profile and observation window with SEND. Open rate is MPP-sensitive proxy evidence; direct action and the program's declared outcome truth set carry the outcome read.

When This Must Trigger

  • Before a material broadcast/sequence release when channel safety is uncertain.
  • When authentication, consent, suppression, complaints, frequency, claims, or attribution need a gate.
  • When the user requests an EQS/SEND baseline or rerun.

Quick Start

Audit this newsletter using the last 90 days, provider split, MPP share, and subscription truth set.
Check this promotional send against DMARC, consent events, live suppressions, claims, and order IDs.

Skill Contract

Reads: one program/profile, normalized window, provider evidence, live consent/suppression state, rendered messages, and outcome truth. Writes: only a permissioned v3 artifact. Done when: all expected SEND states are explicit and the scorer result is reported without sending email or changing provider settings.

Use deliverability-qa to repair authentication, consent-registry for lawful-basis/suppression facts, email-sequence-designer for journeys, and send-experiment-designer for preregistered tests.

Data Sources

NeedPreferred evidence
AuthenticationDNS, message headers, DMARC aggregate evidence
Consent/suppressionAppend-only consent events plus current live projection
Placement/reputationProvider/seed panel and dated ESP/provider reports
EngagementCohort/provider/MPP-segmented ESP export
LifecycleTrigger/flow configuration and event export
OutcomeEcommerce, CRM, subscription, sponsorship, or named equivalent truth set
ContentRendered message/destination and approved claim/disclosure state

Instructions

Runtime Reads

  • ../../../references/auditor-runbook.md
  • ../../../references/scoring-semantics.md
  • ../../../references/send-benchmark.md
  • ../../../references/runtime-invocation.md
  • references/auditor-runtime.md

Runtime and Setup

Read ../../../references/auditor-runbook.md, scoring-semantics.md, send-benchmark.md, and the SEND catalog entry. Standalone installs use bundled immutable references/auditor-runtime.md; never fetch mutable main. Before deterministic calls, follow runtime-invocation.md, resolve AARON_SKILLS_ROOT="${CLAUDE_PLUGIN_ROOT:-$(git rev-parse --show-toplevel 2>/dev/null || true)}", and require the scorer, validator, and typed catalogs. If unavailable, return score_state: NOT_SCORED / score_confidence: not_scored with no gate verdict or persistent artifact.

Declare profile (promotional|retention|cold-outbound|newsletter), target/program, provider, market, normalized window, list age, MPP share, and observation date.

Evidence and Scoring

  1. Freeze evidence and reconcile provider cohorts/windows before comparing rates.
  2. Score all 20 S1..D5 criteria. Every observed state requires source/date/type/confidence.
  3. E2 is N/A with reason when opens/CTOR are not used. N3/N5 are conditional by program design. Missing records or exports are Unknown, not N/A.
  4. Verify vetoes:
    • SEND-S1: required authentication is demonstrably broken/unaligned.
    • SEND-S2: a purchased/scraped/unlawful list is verified; missing provenance is Unknown.
    • SEND-N1: opt-out is broken/absent or a recorded suppression is not honored.
    • SEND-D1: material claim/disclosure/offer term fails approved evidence.
  5. Run the typed scorer. Use clicks/replies/downstream actions as primary engagement evidence where available; opens/CTOR remain caveated proxy evidence.

For a send-only review without enough program evidence, report the verified red-line checks and exact gaps but return NOT_SCORED/UNDECIDED; “no blocker observed in supplied evidence” is not a full SEND SHIP verdict.

§2 SEND Worked Examples

  • Complete newsletter profile, raw 81, no veto/fail: DONE/SHIP, final 81.
  • Complete promotional profile, raw 76, one verified S1 failure: DONE_WITH_CONCERNS/FIX, final 59.
  • Complete profile, verified S2 and N1 failures: DONE/BLOCK, no final score.
  • Consent provenance absent: S2 Unknown, NEEDS_INPUT/UNDECIDED, no score.

§3 SEND Guardrails

  • DMARC p=none with aligned SPF/DKIM and active monitoring is not automatically an S1 failure.
  • Provider one-click-unsubscribe policy and statutory duties must be named separately.
  • Opens and CTOR require MPP segmentation/proxy caveat; they cannot establish human attention alone.
  • A newsletter need not have cart/post-purchase flows; score only journeys applicable to its declared program.
  • Over-frequency is a serious E4/E5 finding, not an automatic veto.

§5 SEND Translation

Explain channel and recipient risk in plain language. On trace request, qualify SEND-S1/S2/N1/D1 and show the underlying DNS/event/rendered evidence.

Report and Verdict

Begin with the auditor-runbook's exact typed conversation header. Never replace status, verdict, or score_state with prose; list each explicitly missing qualified item as ``ID: `unknown``` before findings.

Show verdict, profile/context, score or coverage/interval, confidence, S/E/N/D detail, outcome truth set, verified critical controls, Unknown inputs, and fix owners. Do not claim deliverability/inbox placement from DNS alone and do not execute a send.

Validation Checkpoints

  • Program/profile/provider/window/list age/market/MPP share are declared.
  • Live suppression state was verified by replay, not a stale projection or pending proposal.
  • All 20 states are valid; conditional N/A has a reason.
  • Provider metrics and reconciled outcome truth are separated.
  • No email/provider mutation occurred without separate explicit approval.

Persistence

Persist only after explicit authorization to memory/audits/email/YYYY-MM-DD-<topic>.md. Preserve the scorer's orthogonal status and verdict; validate the complete v3 draft with validate-audit-artifact.py against the intended --relative-path, persist only through one full-content Write, and revalidate the target per the auditor runbook. Edit/shell/MCP mutations of the reserved sink are unsupported. Do not autonomously modify consent, claims, provider settings, or hot cache.

Reference Materials

Next Best Skill

Reviews

No reviews yet. Tell others what you thought.

Comments

No login needed. Share how it worked for you, ask a question, or note where it did not run.

No comments yet. Be the first to write one.

Comments are published right away. Do not include personal information such as email addresses or phone numbers. Up to 2 URLs.

0 / 1,000 characters

This form is protected by reCAPTCHA, and the Google Privacy Policy and Terms of Service apply.

More skills from this repository

Audit paid advertising accounts before increasing spend by comparing campaign exports with your own sales or lead records. Review 20 criteria covering measurement, spending, and safety, then receive a decision and prioritized fixes.

  • Review an ad account before increasing its budget
  • Check reported ad returns against sales and lead records
  • Identify wasted spend and prioritize measurement fixes
aaron-he-zhu/aaron-marketing-skills3KUpdated Oct 23, 2026

Create paid-ad headlines, descriptions, and opening hooks that match the destination page. Build a matrix of messaging angles and variants, check format limits, and flag unsupported claims or policy risks before handing the set off for review.

  • Drafting responsive search ad headlines and descriptions
  • Comparing ad angles and opening hooks
  • Replacing weak headlines while keeping successful ones
aaron-he-zhu/aaron-marketing-skills3KUpdated Oct 23, 2026

ad-test-designer

FreeSummary

Plan advertising and landing page experiments with a clear hypothesis, controlled variants, sample sizes, and duration. Interpret exported results by separating statistical evidence from meaningful business impact, applying an action rule only when its owner approved it in advance.

  • Plan an A/B test for landing page headlines
  • Estimate sample size and duration for an ad test
  • Assess effect size and uncertainty in exported test results
aaron-he-zhu/aaron-marketing-skills3KUpdated Oct 23, 2026

Design employee and founder sharing programs with voluntary participation, personalized share kits, disclosure lines, and staggered posting windows. Get roster and Slack or Teams distribution specifications, plus safeguards against identical coordinated posts and organized engagement exchanges.

  • Designing a voluntary employee sharing program
  • Preparing personalized launch share kits
  • Planning founder posts and disclosure lines
aaron-he-zhu/aaron-marketing-skills3KUpdated Oct 23, 2026

Reconcile paid advertising conversions with GA4 or ecommerce order records. Identify duplicate and unmatched claims, align attribution windows and currencies, compare how models assign credit, and assess additional orders when test and control data are available.

  • Find sales claimed by both Meta and Google
  • Build a monthly conversion reconciliation workbook
  • Compare results across attribution models
aaron-he-zhu/aaron-marketing-skills3KUpdated Oct 23, 2026

Turn customer interviews and won or lost deal notes into a map of buyer beliefs, recurring objections, and reasons to switch or stay. Each finding includes its evidence, with suggested ways to address objections and clear labels for assumptions.

  • Map buyer beliefs from customer interviews
  • Organize recurring sales objections and response angles
  • Identify reasons buyers switch or stay
aaron-he-zhu/aaron-marketing-skills3KUpdated Oct 23, 2026

See all skills by aaron-he-zhu

Report a problem with this skill