CtrlK
BlogDocsLog inGet started
Tessl Logo

designing-email-templates

Author, save, and edit email templates in the PostHog workflows library — compose email design JSON with Liquid personalization and create and round-trip-edit templates over MCP. Use when asked to design, build, update, or fix an email template for workflows, broadcasts, or campaigns.

77

Quality

96%

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

100%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, highly actionable skill body that pushes schema and design detail into two real reference files while keeping concrete tool calls, examples, and validation steps inline. It is lean, executable, and clearly sequenced.

DimensionReasoningScore

Conciseness

Lean and dense for its scope — no padding about what email/Liquid/JSON are; every section is actionable domain knowledge and rationale given is non-obvious (click-tracking breaking deeplinks, text-part deliverability) rather than Claude-known concepts.

5 / 5

Actionability

Fully executable guidance: named MCP tools throughout, a complete create-payload JSON example, a copy-paste curl upload command, and Liquid/HTML snippets covering the common cases.

5 / 5

Workflow Clarity

Multi-step processes (read-modify-write, image presigned upload, workflow-step patching) are numbered with explicit validation checkpoints — fetch fresh design, render preview after create/update, test-run with use_draft=true before workflows-publish.

5 / 5

Progressive Disclosure

SKILL.md is an operational overview with two well-signaled one-level-deep references (design-guidelines.md, unlayer-design-json.md) for schema/design detail; both files exist and bulk material is correctly split out of the body.

5 / 5

Total

20

/

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, third-person description that states concrete capabilities and an explicit 'Use when' trigger tied to natural user phrasing. The only gap is some missing synonyms (newsletter, blast) in trigger coverage.

DimensionReasoningScore

Specificity

Lists multiple concrete actions — 'Author, save, and edit email templates', 'compose email design JSON with Liquid personalization', 'create and round-trip-edit templates over MCP' — giving comprehensive coverage of what the skill does.

5 / 5

Completeness

Explicitly answers both 'what' (author/save/edit templates, compose design JSON with Liquid, round-trip-edit over MCP) and 'when' ('Use when asked to design, build, update, or fix an email template for workflows, broadcasts, or campaigns') with concrete trigger phrases.

5 / 5

Trigger Term Quality

Natural user-facing verbs and contexts are present ('design, build, update, or fix an email template for workflows, broadcasts, or campaigns'), but common synonyms such as 'newsletter' or 'email blast' are not covered.

4 / 5

Distinctiveness Conflict Risk

The PostHog workflows email-template niche is specific with distinct triggers (workflows, broadcasts, campaigns) and minimal overlap risk with other skills.

5 / 5

Total

19

/

20

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.

Validation16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository
PostHog/posthog
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.