Use when asking about email deliverability, compliance (CAN-SPAM, GDPR, CASL), transactional email design patterns, list management, testing safely, or general email best practices — provider-agnostic knowledge with Postmark-specific guidance.
80
73%
Does it follow best practices?
Impact
87%
1.08xAverage score across 3 eval scenarios
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./postmark-email-best-practices/SKILL.mdQuality
Discovery
89%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
This is a strong description with excellent trigger terms and clear 'when to use' guidance. Its main weakness is that it describes knowledge areas rather than concrete actions the skill performs — it reads more like a topic list than a capability list. Adding specific verbs describing what the skill does (e.g., 'diagnoses', 'recommends', 'generates') would strengthen it further.
Suggestions
Add concrete action verbs describing what the skill does, e.g., 'Diagnoses email deliverability issues, recommends compliance strategies for CAN-SPAM/GDPR/CASL, designs transactional email patterns' rather than just listing topic areas.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | The description names the domain (email) and lists several topic areas (deliverability, compliance, transactional email design patterns, list management, testing), but these are more like categories of knowledge than concrete actions. It doesn't specify what actions the skill performs (e.g., 'diagnoses deliverability issues', 'generates compliant email templates'). | 2 / 3 |
Completeness | The description explicitly starts with 'Use when...' providing clear trigger guidance, and the latter portion ('provider-agnostic knowledge with Postmark-specific guidance') clarifies what the skill provides. Both 'what' and 'when' are addressed with explicit triggers. | 3 / 3 |
Trigger Term Quality | Excellent coverage of natural trigger terms users would say: 'email deliverability', 'CAN-SPAM', 'GDPR', 'CASL', 'transactional email', 'list management', 'email best practices', and 'Postmark'. These are terms users would naturally use when seeking help in this domain. | 3 / 3 |
Distinctiveness Conflict Risk | The combination of email deliverability, compliance frameworks (CAN-SPAM, GDPR, CASL), transactional email patterns, and Postmark-specific guidance creates a very distinct niche that is unlikely to conflict with other skills. The Postmark mention further narrows the scope. | 3 / 3 |
Total | 11 / 12 Passed |
Implementation
57%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This skill is well-structured as an overview document with excellent progressive disclosure to reference files, and the tables provide efficient information density. However, it lacks concrete executable examples (no code, no DNS record examples, no API call examples) and some content explains concepts Claude already understands. The workflow clarity suffers from the absence of step-by-step processes with validation checkpoints for operations like domain authentication setup or bounce handling.
Suggestions
Add at least one concrete, executable code example inline — e.g., a sample API call using the test token, or a DNS TXT record example for SPF/DMARC setup.
Include a step-by-step workflow with validation checkpoints for at least one key process (e.g., domain authentication setup: add SPF → verify → add DKIM → verify → set DMARC → test).
Remove the opening paragraph about Postmark's history and trim explanations of well-known concepts (SPF/DKIM/DMARC purposes, what transactional email is) to just the Postmark-specific guidance.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is generally well-organized with tables that convey information efficiently, but includes some unnecessary framing ('Postmark has delivered billions of transactional emails over 15+ years') and explanations of concepts Claude already knows (what SPF/DKIM/DMARC are, what transactional vs broadcast email means). The tables are efficient but some prose could be tightened. | 2 / 3 |
Actionability | The skill provides useful tables and rules but lacks executable code examples or concrete commands. The testing section has specific addresses and tokens which is good, but deliverability setup, compliance implementation, and sending reliability are all deferred to reference files without any inline code or concrete implementation steps. | 2 / 3 |
Workflow Clarity | The skill provides clear categorization and rules (e.g., 'Remove hard bounces immediately') but lacks sequenced multi-step workflows with validation checkpoints. For operations like domain setup, bounce handling, or list hygiene, there are no step-by-step processes with verification steps — just rules and references to other files. | 2 / 3 |
Progressive Disclosure | Excellent progressive disclosure structure — the main file serves as a clear overview with well-organized sections, each pointing to one-level-deep reference files (deliverability.md, compliance.md, transactional-design.md, list-management.md, testing.md, sending-reliability.md). Navigation is clear and references are well-signaled. | 3 / 3 |
Total | 9 / 12 Passed |
Validation
100%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 11 / 11 Passed
Validation for skill structure
No warnings or errors.
73ea6bf
Table of Contents
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.