List Email Templates

This skill teaches Claude how to discover which email templates are registered in the SchemaVaults mail-server catalog. Template IDs are needed when sending template-based emails via sendEmail() or sendEmailToMailingList() from @schemavaults/send-email. Because the template catalog changes over time, this skill intentionally does not hardcode a list -- always query the live catalog.

When to use this skill

• Before sending a template-based email, to find the correct template_id and understand the expected template_props shape.
• When unsure whether a template exists for a particular notification type.
• When the user asks "what email templates are available?"

Prerequisites

• SCHEMAVAULTS_MAIL_API_KEY must be set -- the same API key used for sending emails. The GET /api/templates endpoint accepts the same bearer-token auth as POST /api/send.

Usage -- with the listEmailTemplates() helper (preferred)

The @schemavaults/send-email package exports a listEmailTemplates() function that handles API key resolution, environment-aware URL lookup, and response parsing -- the same conventions as sendEmail():