CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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

Quality

81%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

SKILL.md
Quality
Evals
Security

Quality

Content

71%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

A tightly written, highly actionable audit procedure with explicit validation checkpoints and a well-designed fallback for missing runtime dependencies. Its main structural weakness is reference hygiene: most detail files are referenced by fragile out-of-bundle `../../../` paths, lists are duplicated across sections, and the §-numbered sections skip numbers, which hurts navigation more than correctness.

Suggestions

Consolidate the three overlapping reference lists ("Runtime Reads", "Runtime and Setup", "Reference Materials") into a single reference section to remove redundancy.

Make all referenced files resolvable from the skill bundle — either bundle auditor-runbook.md, scoring-semantics.md, send-benchmark.md, runtime-invocation.md, and measurement-protocol.md under references/, or inline the essential scoring rules — instead of relying on `../../../references/` paths that escape the skill directory.

Renumber the §2/§3/§5 sections into one coherent ordered sequence (or drop the § prefixes) and present the declare→freeze→score→veto→score→report flow as a single numbered list.

DimensionReasoningScore

Conciseness

The body is dense and assumes domain competence — it never explains what DMARC, MPP, or suppression lists are — so nearly every token earns its place. It sits at 4 rather than 5 because the file lists are repeated three times ("Runtime Reads", "Runtime and Setup", "Reference Materials" all re-list auditor-runbook.md, scoring-semantics.md, and send-benchmark.md) and the odd §2/§3/§5 numbering adds noise.

4 / 5

Actionability

Concrete, executable instruction-only guidance: exact status strings ("return `score_state: NOT_SCORED` / `score_confidence: not_scored`"), an exact env resolution (`AARON_SKILLS_ROOT="${CLAUDE_PLUGIN_ROOT:-...}"`), a concrete persistence path pattern (`memory/audits/email/YYYY-MM-DD-<topic>.md`), and a named validator command (`validate-audit-artifact.py ... --relative-path`). Minor gaps keep it from 5: the scorer invocation itself is delegated to an out-of-bundle file and worked examples give scores without the criterion-level math.

4 / 5

Workflow Clarity

A clear sequence is present — declare profile, freeze evidence, score S1..D5, verify the four vetoes, run the typed scorer, report with the exact typed header — with an explicit "Validation Checkpoints" checklist and a validate→persist→revalidate feedback loop for the one write operation. It is not 5 because the flow is fragmented across many sections, the §-numbered sections appear out of order with no §4, and error-recovery detail lives in external files rather than inline.

4 / 5

Progressive Disclosure

Sectioning is decent and the one bundled file (references/auditor-runtime.md, a generated 458-line framework snapshot) is a real, one-level-deep reference. But five of the six referenced detail files (`auditor-runbook.md`, `scoring-semantics.md`, `send-benchmark.md`, `runtime-invocation.md`, `measurement-protocol.md`) resolve via `../../../references/` outside the skill directory and are absent from the bundle, and the reference lists are duplicated across three sections — 'some structure but could be better organized' rather than the mostly-clean 4.

3 / 5

Total

15

/

20

Passed

Description

87%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description: third-person, concrete about the audit mechanics, with explicit trigger phrases and unusually good negative-boundary routing to sibling skills. The only minor weaknesses are a couple of missing natural trigger synonyms and output-shape detail being implied rather than stated.

DimensionReasoningScore

Specificity

"runs a typed 20-item SEND profile with authentication, consent, opt-out, and claim veto checks on own evidence" names several concrete, concrete-scoped actions. It falls short of the 5 anchor because the produced output (EQS score / gate verdict) is only implied via the Chinese summary, and the trailing bilingual keywords add no capability detail.

4 / 5

Completeness

It explicitly answers both questions: what ("runs a typed 20-item SEND profile with ... veto checks") and when ("Use when the user asks to ..." with two concrete trigger phrases), and even adds explicit when-not-to-use boundaries. This matches the 5 anchor's 'clearly and explicitly answers both what AND when with concrete trigger phrases'; below it (4) would require the 'when' to be less explicit, which it is not.

5 / 5

Trigger Term Quality

Quotes natural trigger phrases users would say — "audit an email program" and "is this campaign safe to send" — plus EQS/SEND and Chinese equivalents. A few natural variations (e.g., "pre-send check", "email QA", "is this safe to send") are absent, matching the 'good coverage, a few natural terms missing' anchor rather than the comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

"Not for building deliverability setup — use deliverability-qa; not for designing lifecycle flows — use email-sequence-designer" carves out a clear niche with explicit routing away from adjacent skills, so conflict risk is minimal — squarely the 5 anchor.

5 / 5

Total

18

/

20

Passed

Validation

81%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 13 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

metadata_field

'metadata' should map string keys to string values

Warning

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

relative_links

Relative link issues: 9 suspicious

Warning

Total

13

/

16

Passed

Repository

aaron-he-zhu/aaron-marketing-skills

Path

email/deliver/email-quality-auditor/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.