send-one-off-email

Send one-off emails via schemavaults-send-email CLI or sendEmail() helper.

Updated Mar 31, 2026
One-click install
npx skills add https://github.com/schemavaults/send-email --skill send-one-off-email
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: send-one-off-email
Source: https://github.com/schemavaults/send-email/tree/main/.claude/skills/send-one-off-email
Command: npx skills add https://github.com/schemavaults/send-email --skill send-one-off-email

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Some teams need to send a one-off notification to specific email addresses or perform quick smoke tests of a mail integration. This skill provides a reliable way to dispatch a single email using either the schemavaults-send-email CLI or the sendEmail() helper in code, without building a longer-lived workflow.

Core Features & Use Cases

  • CLI-based one-off sends: use the schemavaults-send-email binary to send to one or more recipients with subject, text, and html or with a template id and template props.
  • Programmatic usage: import and call sendEmail() from @schemavaults/send-email for application code paths.
  • Flexible body formats: support either raw text/html bodies or template-based messages, with optional sender override and dry-run capabilities.
  • Use Case: smoke test a new API key or validate a template's props by sending a targeted email to a test address.

Quick Start

Invoke the CLI to send a one-off email by supplying --to, --subject, and either --text/--html or a --template-id with template-props.

Frequently Asked Questions about send-one-off-email

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I send a one-off email from the command line?▼

Use the schemavaults-send-email CLI binary to send a single email by supplying --to, --subject, and either --text/--html or a --template-id with template props. You need to set the SCHEMAVAULTS_MAIL_API_KEY environment variable before running the command.

Can I send a single email to multiple recipients at once?▼

Yes, the sendEmail() helper and CLI support sending a single email to between 1 and 50 recipients per call. You can specify multiple recipient addresses to deliver the same message body or template-based content simultaneously.

Do I need an API key to test mail server integration?▼

Yes, the SCHEMAVAULTS_MAIL_API_KEY environment variable is required to authenticate and send emails. You can optionally set SCHEMAVAULTS_APP_ENVIRONMENT to specify the context, and use dry-run capabilities to validate templates and API keys without dispatching actual messages.

What is the best way to smoke test an email template in development?▼

The best way to smoke test an email template is to use the CLI or sendEmail() helper with a --template-id and template props, sending a targeted message to a test address. This verifies template rendering, prop validation, and API key authentication without building a permanent workflow.

Does the sendEmail() helper support raw text and HTML bodies?▼

Yes, the sendEmail() helper supports flexible body formats, allowing you to send either raw text and HTML bodies or template-based messages. It also includes optional sender override and dry-run capabilities for testing without actual delivery.

What are the limitations of sending ad-hoc emails with this approach?▼

The main limitation is a maximum of 50 recipients per call, and the tool is designed specifically for single ad-hoc sends rather than longer-lived workflows. It requires a valid SCHEMAVAULTS_MAIL_API_KEY to function in development or production environments.