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.