stacks-mail

Define and dispatch template-based application emails with variable interpolation.

2|Updated Jul 8, 2026
One-click install
npx skills add https://github.com/bughq/bughq --skill stacks-mail-bughq
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: stacks-mail
Source: https://github.com/bughq/bughq/tree/main/.claude/skills/stacks-mail
Command: npx skills add https://github.com/bughq/bughq --skill stacks-mail-bughq

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill simplifies the process of defining, templating, and sending application-level emails, removing the complexity of manual HTML construction and repetitive boilerplate code.

Core Features & Use Cases

  • Template-Driven Emails: Easily render email content using STX or HTML templates with automatic variable interpolation.
  • Layout Management: Wrap email content in consistent layouts to maintain brand identity across all communications.
  • Use Case: When building a user onboarding flow, use this Skill to define a welcome email class that injects dynamic user data into a pre-defined template and sends it via the configured mail driver.

Quick Start

Use the stacks-mail skill to generate a new email class in app/Mail/ that sends a subscription confirmation message using the subscription-confirmation template.

Frequently Asked Questions about stacks-mail

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

FAQPage Schema
How do I send templated application emails without writing repetitive HTML boilerplate?

Use a template-driven email framework that renders STX or HTML templates with automatic variable interpolation, eliminating manual HTML construction. You define a mail class, inject dynamic data, and the framework handles rendering and dispatching through a configured mail driver.

How do I maintain consistent branding across transactional email notifications?

Layout management wraps email content in consistent layouts to maintain brand identity across all communications. You define a shared layout template once, and every email class applies it automatically during the rendering process.

How does variable interpolation work in email templates for dynamic user data?

Variable interpolation injects dynamic values into predefined email templates at render time. When defining a mail class, you pass data like user names or subscription details, and the template engine replaces placeholder variables with the actual values before dispatch.

Do I need the @stacksjs/email package to handle template rendering and mail delivery?

Yes, the @stacksjs/email package is required to manage template rendering and mail delivery patterns. It provides the underlying driver integration and template engine that the email classes depend on for rendering and sending messages.

Can I integrate email dispatch with existing action or event handlers in a TypeScript application?

Yes, the framework supports integration with existing action or event handlers. You define an email class in your Mail directory and trigger it directly from those handlers, passing contextual data into the template for rendering and dispatch.

What is the best way to structure email classes for a user onboarding workflow?

Generate a dedicated email class in your Mail directory for each communication, such as a welcome message. The class binds a specific template, accepts dynamic user data as variables, and leverages layout wrapping to ensure consistent presentation across the onboarding sequence.