本文へ移動
cccskills
無料GitHub で公開

email-quality-auditor

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评分/发送前放行

インストール方法を見る

含まれるファイル(2)

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

SKILL.md(原文)

インストールする前に、エージェントに与えられる指示の中身を確認できます。

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

レビュー

まだレビューはありません。使ってみた感想をお寄せください。

同じリポジトリのスキル

概要と使いどころ

Use when auditing a paid ad account for incremental contribution, wasted spend, or measurement integrity before scaling; runs a typed 20-item ROAS profile with verified vetoes and a SHIP/FIX/BLOCK/UNDECIDED gate on own exported data. Not for campaign structure design — use campaign-architect; not for creative production — use ad-creative-builder. 付费广告账户审计/ROAS评分

日本語の概要は準備中です。原文の説明を表示しています。

aaron-he-zhu/aaron-marketing-skills2,9122026年10月12日 更新

Use when the user asks to "write ad copy", "generate RSA headlines", or "build ad creative at volume"; produces ad units — RSA headlines/descriptions, hooks, and an angle matrix — message-matched to the destination landing page. Not for scoring an ad account — use ad-account-auditor; not for the post-click page — use landing-optimizer; not for organic articles — use content-writer. 广告创意/广告文案/RSA标题

日本語の概要は準備中です。原文の説明を表示しています。

aaron-he-zhu/aaron-marketing-skills2,9122026年10月12日 更新

Use when the user asks to "design an A/B test", "set up a creative/landing test", "run an incrementality test", or "is this result statistically and practically material?"; produces a hypothesis, variant matrix, sample-size/duration/power plan, and a documented effect/uncertainty read from own exported results. It applies only a precommitted owner-approved action rule; the statistical helper never chooses a business action. Not for producing variants — use ad-creative-builder; not for reading back one shipped change — use paid-measurement-loop. 广告AB测试设计/实验设计/显著性判定/增效测试

日本語の概要は準備中です。原文の説明を表示しています。

aaron-he-zhu/aaron-marketing-skills2,9122026年10月12日 更新

Use when the user asks to "design an employee advocacy program", "set up founder-led sharing", or "build a share kit for the team"; produces an advocacy program blueprint in two modes — participation-driven opt-in (default) or top-down assigned with its coercion and authenticity risks flagged — with a voluntary opt-in roster spec submitted as channel-registry proposal events, share kits with mandatory per-person variation, staggered human posting windows plus anti-pod guardrails (no coordinated identical reshares, no engagement rings), per-person material-connection disclosure lines per FTC and 《互联网广告管理办法》, and a Slack/Teams distribution spec. Not for paid creator campaigns — use campaign-planner. 员工倡导/创始人IP分享/内部分享计划/披露合规

日本語の概要は準備中です。原文の説明を表示しています。

aaron-he-zhu/aaron-marketing-skills2,9122026年10月12日 更新

Use when platform-reported conversions disagree with GA4/ecommerce, when you suspect Meta and Google are double-counting the same sales, or for a standing (monthly) reconciliation workbook that de-dups stacked credit against an order-ID truth set, normalizes attribution windows and currency, compares attribution models, and reads incrementality from a geo/holdout test. Not for the point-in-time R2 veto or RQS gate — use ad-account-auditor; not for the ROI/ROAS ratio math itself — use roi-calculator; not for organic dark-social share attribution or GA4 direct-traffic decomposition — use dark-social-attributor. 付费广告归因对账/去重/增量

日本語の概要は準備中です。原文の説明を表示しています。

aaron-he-zhu/aaron-marketing-skills2,9122026年10月12日 更新

Use when the user asks to "map what our buyers believe", "capture the objections we keep hearing", or "find the switching forces that move the beachhead"; produces a belief map of the beachhead — held beliefs and mental models, the recurring objections and their reframes, and the JTBD four forces (push of the problem, pull of the new, anxiety of switching, habit of the present) — each item sourced from interviews or win-loss notes (User-provided) and labeled Measured / User-provided / Estimated, with any unverified quote or comparative claim marked "[needs source]" and routed to the claims candidates, never adjudicated here. Not for demographic or persona profiling — use audience-mapper; not for the positioning canvas — use positioning-truth-tracer. 受众信念/异议地图/切换四力/流失语言

日本語の概要は準備中です。原文の説明を表示しています。

aaron-he-zhu/aaron-marketing-skills2,9122026年10月12日 更新

aaron-he-zhu のスキルをすべて見る

このスキルの問題を報告する