CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

preference-frequency-manager

Use when the user asks to "build a preference center", "set up a frequency opt-down ladder", "give people a step-down instead of unsubscribe", or "design a topic/cadence preference page"; produces a preference-center field spec, a frequency/topic opt-down ladder (down-tier paths that substitute for a hard unsubscribe), a preference-to-suppression mapping, and a SEND N-dimension sub-item note on preference-center / frequency options offered. Not for the lifecycle flow map or cadence governance — use email-sequence-designer; not for the consent/suppression record itself — use consent-registry; not for computing EQS or ruling the N1 unsubscribe veto — use email-quality-auditor. 邮件偏好中心/降频阶梯设计/退订替代降档

Quality

84%

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

73%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 well-structured instruction-only skill with an exemplary sequenced workflow, decision gates, and a done-when contract, plus genuinely concrete mapping rules. Its weaknesses are verbosity from repeating the same boundary disclaimers four-plus times and reliance on external files for output templates. Progressive disclosure is good but the bundle itself contains no files, delegating everything to cross-repo references.

Suggestions

State the boundary triad (not lifecycle flows / not the consent record / not EQS or N1) once — in the scope guard — and cut its near-verbatim repeats from the intro, instruction 7, and the description body of Next Best Skill.

Include a short inline example of the emitted outputs (a mini field-spec row, one ladder rung, a sample N sub-item note) instead of delegating all output shapes to skill-contract.md.

Centralize the repeated cross-skill links in Reference Materials and reference them from the body once each, rather than re-linking consent-registry and email-sequence-designer multiple times per section.

DimensionReasoningScore

Conciseness

The body is dense with domain-specific, non-obvious content and does not tutor Claude on known concepts, but the same boundary triad (not lifecycle flows / not the consent record / not EQS or N1) is restated nearly verbatim in the intro, instruction 7, the scope guard, and Next Best Skill — several padded sections that could be consolidated. Not 2 because the repetition is the only significant padding; the remaining content earns its tokens; not 4 because the repetition is substantial enough that tightening would remove a noticeable fraction of the body.

3 / 5

Actionability

Instructions give concrete, executable design guidance: a concrete ladder ("weekly → monthly → quarterly → pause 90 days"), concrete mapping rules ("monthly tier → cap sends to 1/month; pause 90d → suppress until date, then resume prior tier"), Pass/Partial/Fail definitions for the sub-item note, and exact memory paths. Not 5 because no example of the emitted output shape (field spec, ladder, or sub-item note) is shown inline — the format is delegated to skill-contract.md, leaving minor gaps for a copy-paste-ready result.

4 / 5

Workflow Clarity

Eight clearly sequenced numbered steps (confirm profile → inventory opt-out path → topics → tiers → ladder → mapping → sunset → emit note), plus explicit validation checkpoints: a Decision Gates section (stop-and-ask vs continue-silently with concrete examples), a "Done when" contract, and a termination note with hop limits and ambiguity handling. Not 4 because checkpoints are explicit and prescriptive, not implicit; the design task is not destructive/batch so no validation cap applies.

5 / 5

Progressive Disclosure

Good structure: overview-oriented body with clear sections, and a Reference Materials section listing each cross-skill reference with a one-line description of what it covers — references are one level deep and well signaled. Not 5 because the skill ships no bundle files of its own (no references/, scripts/, or assets/ exist in the bundle) and all references point outside the skill directory to shared/sibling files, so navigation depends on an external repo layout rather than a self-contained, appropriately split bundle; some reference links are also duplicated inline in Instructions and Skill Contract rather than centralized.

4 / 5

Total

16

/

20

Passed

Description

92%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: concrete deliverables, explicit quoted trigger phrases, and named disambiguation against three sibling skills. The only weakness is that some trigger phrasing is domain jargon and a few natural synonyms are absent. The trailing Chinese summary ("邮件偏好中心/降频阶梯设计/退订替代降档") adds a redundant locale-specific echo of the same content.

Suggestions

Add one or two plain-language trigger variants (e.g., "let people choose how often they get emails", "email preferences page") alongside the current quoted phrases.

Drop the trailing Chinese summary phrase from the description — it duplicates the summary field and adds tokens without new trigger value.

DimensionReasoningScore

Specificity

Quotes four concrete deliverables — "produces a preference-center field spec, a frequency/topic opt-down ladder (down-tier paths that substitute for a hard unsubscribe), a preference-to-suppression mapping, and a SEND N-dimension sub-item note" — giving comprehensive, concrete coverage of what the skill outputs. Not 4 because the action list covers the domain completely with no meaningful gaps in coverage.

5 / 5

Completeness

Explicitly answers both: "Use when the user asks to..." gives concrete trigger phrases for when, and "produces a preference-center field spec..." states exactly what it does. Explicit negative boundaries ("Not for the lifecycle flow map... use email-sequence-designer") further sharpen both. Not 4 because neither what nor when could be more explicit — both use concrete quoted phrases.

5 / 5

Trigger Term Quality

Four quoted natural trigger phrases users would actually say ("build a preference center", "give people a step-down instead of unsubscribe", "design a topic/cadence preference page") give good coverage. Not 5 because common variations like "email preferences page", "let people choose how often they get emails", or "opt-down" as a standalone term are missing, and several phrases ("frequency opt-down ladder", "SEND N-dimension") lean on skill-internal jargon rather than natural user speech.

4 / 5

Distinctiveness Conflict Risk

Occupies a clear niche (preference center / opt-down ladder design) and explicitly routes the three adjacent tasks to named sibling skills ("use email-sequence-designer... use consent-registry... use email-quality-auditor"), minimizing wrong-skill triggering. Not 4 because the conflict risk is not merely minor — it is actively disambiguated by named redirects.

5 / 5

Total

19

/

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: 29 suspicious

Warning

Total

13

/

16

Passed

Repository

aaron-he-zhu/aaron-marketing-skills

Path

email/nurture/preference-frequency-manager/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.