Agent skill

Email Setup

by vellum-ai in vellum-ai/vellum-assistant

Set up this assistant's own [name].vellum.me domain and email address (one-time setup)

MITAuto-check passed

Install Email Setup

skills CLI
$ npx skills add vellum-ai/vellum-assistant --skill email-setup -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install vellum-ai/vellum-assistant email-setup --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/vellum-ai/vellum-assistant.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/email-setup .claude/skills/email-setup && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
email-setup
GitHub stars
1.4k
Token cost
~1k tokens
SKILL.md length
506 words
Files
1
Skills in repo
108
Repo updated
First seen
Licence
MIT

At a glance

Set up this assistant's own [name].vellum.me domain and email address (one-time setup)

  • Works in 5 steps: Check if Domain & Email Already Exist → Register Your Domain → Register Your Email → …
  • SKILL.md covers Prerequisites, Step 1: Check if Domain &…, Step 2: Register Your Domain and Step 3: Register Your Email, plus 5 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Email Setup is an agent skill from vellum-ai/vellum-assistant. Set up this assistant's own [name].vellum.me domain and email address (one-time setup)

Its SKILL.md is about 1k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts. Compatibility notes: Designed for Vellum personal assistants

The repository describes itself as: An AI Assistant that’s easy to setup, does your work 24/7, knows your preferences and gets better over time. The licence is MIT.

Example prompts

  • “/email-setup”

Requirements

  • Compatibility (from SKILL.md): Designed for Vellum personal assistants

Workflow steps

5 steps, taken from the step headings in SKILL.md.

  1. Check if Domain & Email Already Exist
  2. Register Your Domain
  3. Register Your Email
  4. Verify Status
  5. Confirm Setup

What it can do on your machine

Read from SKILL.md and the folder at commit 844117a. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are bash).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

  • Compatibility

    Designed for Vellum personal assistants

    From compatibility in the SKILL.md frontmatter.

Context cost

Email Setup loads about 1k tokens when it runs. Until then it costs about 25 tokens; SKILL.md has 506 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~25
When it runs · the whole SKILL.md, loaded when a task matches
~1k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from vellum-ai/vellum-assistant at commit 844117a, republished under its MIT licence (© vellum-ai). 506 words, ~1,045 tokens.

Download SKILL.mdSave it as .claude/skills/email-setup/SKILL.md (or your agent's skills folder).
name
email-setup
description
Set up this assistant's own `[name].vellum.me` domain and email address (one-time setup)
compatibility
Designed for Vellum personal assistants
metadata.emoji
📧

You are setting up your own custom domain and email address. This is a one-time operation — once you have a domain and email, you do not need to run this again.

Prerequisites

Only proceed if the user explicitly asks you to create or set up your own (the assistant's) email address — e.g., "set up your email", "create your email address", "I want you to have your own email". Generic email requests like "send an email", "check my email", or "set up email" are about the user's personal email and should be handled by the Messaging skill, not this one. Do NOT proactively run this skill.

Step 1: Check if Domain & Email Already Exist

bash
assistant domain status --json
assistant email status --json

If both commands show an active domain and email address, tell the user the existing address and stop.

If an email exists but no domain, the email was set up under the legacy shared domain — it still works. Ask the user if they want to keep it or migrate to a custom subdomain.

Step 2: Register Your Domain

Each assistant gets its own subdomain (e.g. mybot.vellum.me). This must be registered before creating an email address.

bash
assistant domain register <subdomain>

For <subdomain>, use your assistant name (lowercased, alphanumeric, hyphens allowed). Check your identity from IDENTITY.md to determine your name. If you don't have a name yet, ask the user what subdomain they'd like.

If the domain is already registered, domain status will show it — skip to Step 3.

Step 3: Register Your Email

Once the domain is active, register your email username on that domain:

bash
assistant email register <username>

This creates <username>@<subdomain>.vellum.me. Use the same name as your subdomain for simplicity (e.g. mybot@mybot.vellum.me), or ask the user if they prefer a different local part.

Step 4: Verify Status

bash
assistant email status --json

Confirm the address is active.

Step 5: Confirm Setup

  1. Tell the user your new email address.
  2. Store a note in your memory that your domain and email have been provisioned.
Show full SKILL.md (192 more words)Show less

Rules

  • One-time only. If a domain and email already exist, do not register another.
  • Domain first. email register will fail if no domain is registered. Always check/register the domain before the email.
  • User-initiated only. Never run this skill unless the user asks.
  • No API key prompting. Email is handled through the Vellum platform — no provider API keys or DNS configuration needed.

Troubleshooting

Domain registration failed

If assistant domain register returns an error (e.g. subdomain taken), try a variation (append a number or use a nickname) and retry once. If it still fails, report the error to the user.

Email registration failed

If assistant email register returns an error:

  • "No domain registered" — run assistant domain register first.
  • Username taken — try a different local part.
  • Other errors — report the error to the user.

Email Management

Once set up, the assistant has full email capabilities:

CommandDescription
assistant email send <to...> -s "Subject" -b "Body"Send an email (supports --cc, --bcc, --reply-to)
assistant email listList sent and received emails
assistant email download <id>Download a specific email
assistant email statusCheck email address status and usage
assistant email unregister --confirmRemove the email address

© vellum-ai, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/email-setup of vellum-ai/vellum-assistant.

Open the folder on GitHubat commit 844117a

Compare with similar skills

Email Setup next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Email Setup compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Email Setup this skillvellum-ai/vellum-assistant1.4k—~1kAutomated safety check: PassMIT
Emailasgeirtj/system_prompts_leaks69k—~3.5kAutomated safety check: PassCC0-1.0
Emailscoreyhaines31/marketingskills54k1 repos~2.8kAutomated safety check: PassMIT
Mailtrap Email Integrationaffaan-m/ECC276k1 repos~955Automated safety check: PassMIT
Email Marketing Biblesickn33/agentic-awesome-skills47k—~8.7kAutomated safety check: PassMIT
Email Systemsdavila7/claude-code-templates32k2 repos~548Automated safety check: PassMIT

Similar skills

  • Email

    asgeirtj/system_prompts_leaks

    Read or triage email, clean up an inbox, draft or send messages, and check delivery.

    69k GitHub stars~3.5k tokensUpdated yesterday
    Productivity & AutomationAuto-check passed
  • Emails

    coreyhaines31/marketingskills

    When the user wants to create or optimize an email sequence, drip campaign, automated email flow, or lifecycle email program.

    54k GitHub starsUsed in 1 repo~2.8k tokens
    Marketing & SEOAuto-check passed
  • Guides agents through integrating transactional email sending via Mailtrap's Email API, including sandbox testing, domain verification, and API authentication.

    276k GitHub starsUsed in 1 repo~955 tokens
    Backend & APIsAuto-check passed
  • Email Marketing Bible

    sickn33/agentic-awesome-skills

    Data-backed email marketing for AI agents: automation flows, deliverability triage, copy de-slopping, AI email design, ESP control via MCP with send gates and compliance.

    47k GitHub stars~8.7k tokensUpdated today
    Marketing & SEOAuto-check passed
  • Email Systems

    davila7/claude-code-templates

    Email has the highest ROI of any marketing channel. An agent skill from davila7/claude-code-templates.

    32k GitHub starsUsed in 2 repos~548 tokens
    Backend & APIsAuto-check passed
  • Email Manager

    LeoYeAI/openclaw-master-skills

    When user asks to write email, draft reply, manage inbox, email template, follow up email, cold email, professional email, email subject line, thank you email, apology email, meeting request email…

    2.2k GitHub stars~5.5k tokensUpdated 2 mo ago
    Writing & ContentAuto-check passed

More from vellum-ai/vellum-assistant

All 108 skills in this repo
  • Vellum GitHub App Setup

    vellum-ai/vellum-assistant

    Create and configure a GitHub App so the assistant can push commits, open PRs, and comment under its own bot identity.

    1.4k GitHub stars~3.1k tokensUpdated today
    Auto-check passed
  • Discord App Setup

    vellum-ai/vellum-assistant

    Connect a Discord bot to the assistant via the Discord Gateway with guided application creation and intent configuration

    1.4k GitHub stars~4.2k tokensUpdated today
    Auto-check passed
  • Sentry App Setup

    vellum-ai/vellum-assistant

    Create and configure a Sentry internal integration so the assistant can manage issues, alerts, and releases under its own identity

    1.4k GitHub stars~1.3k tokensUpdated today
    Auto-check passed
  • Memory Corpus Ingest

    vellum-ai/vellum-assistant

    Ingest a large dataset into memory as a skimmed map. An agent skill from vellum-ai/vellum-assistant.

    1.4k GitHub stars~3k tokensUpdated today
    Auto-check: notes
  • Plugin Builder

    vellum-ai/vellum-assistant

    A skill your agent uses when the user wants to build, scaffold, ship, or edit a Vellum plugin that bundles multiple surfaces (hooks, tools, skills, and more) into one installable package.

    1.4k GitHub stars~3.1k tokensUpdated today
    Auto-check passed
  • Slack App Setup

    vellum-ai/vellum-assistant

    Connect a Slack app to the Vellum Assistant via Socket Mode.

    1.4k GitHub stars~2.5k tokensUpdated today
    Auto-check: warnings

Questions about Email Setup

What does Email Setup do?

Set up this assistant's own [name].vellum.me domain and email address (one-time setup). Email Setup is an agent skill from vellum-ai/vellum-assistant.

How do I install Email Setup in Claude Code?

Run `npx skills add vellum-ai/vellum-assistant --skill email-setup -a claude-code`. Or copy the skill folder (skills/email-setup in vellum-ai/vellum-assistant) into .claude/skills/email-setup in your project. Claude Code loads it when a task matches its description.

How do I install Email Setup in Codex?

Run `npx skills add vellum-ai/vellum-assistant --skill email-setup -a codex`. Or copy the skill folder (skills/email-setup in vellum-ai/vellum-assistant) into .agents/skills/email-setup in your project. Codex loads it when a task matches its description.

Can I use Email Setup in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add vellum-ai/vellum-assistant --skill email-setup -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/email-setup, .gemini/skills/email-setup, .github/skills/email-setup and .opencode/skills/email-setup in your project.

What does Email Setup need to run?

SKILL.md names no scripts, command-line tools or credentials: Email Setup is instructions for the agent only. Compatibility (from SKILL.md): Designed for Vellum personal assistants.

Does Email Setup access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Email Setup safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Email Setup use?

Email Setup is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Email Setup use?

About 1k tokens (SKILL.md is roughly 4.2k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Email Setup?

Skills that share tags, products or a category with Email Setup: Email (asgeirtj/system_prompts_leaks, 69k stars), Emails (coreyhaines31/marketingskills, 54k stars), Mailtrap Email Integration (affaan-m/ECC, 276k stars) and Email Marketing Bible (sickn33/agentic-awesome-skills, 47k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Email Setup?

vellum-ai (a GitHub organization) maintains it in vellum-ai/vellum-assistant, which has 1,400 GitHub stars. The repository holds 108 skills in this directory. The repository was last updated on October 9, 2026.

Source: vellum-ai/vellum-assistant on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.