A skill your agent uses when a val sends email, receives email, or is triggered by an incoming email.

Apache-2.0Auto-check passed

Install Email

skills CLI
$ npx skills add hashgraph-online/awesome-codex-plugins --skill email -a claude-code

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

GitHub CLI
$ gh skill install hashgraph-online/awesome-codex-plugins email --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/hashgraph-online/awesome-codex-plugins.git skills-src && mkdir -p .claude/skills && cp -r skills-src/plugins/val-town/plugins/skills/email .claude/skills/email && 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
GitHub stars
1.2k
Token cost
~653 tokens
SKILL.md length
231 words
Files
1
Skills in repo
686
Repo updated
First seen
Licence
Apache-2.0

At a glance

A skill your agent uses when a val sends email, receives email, or is triggered by an incoming email.

  • A val sends email
  • SKILL.md covers Receiving email — email-type…, Sending email — std/email, Replying to an incoming message and Verifying changes
  • Reaches esm.town and docs.val.town
  • Is triggered by an incoming email

What it does

Email is an agent skill from hashgraph-online/awesome-codex-plugins. Use when a val sends email, receives email, or is triggered by an incoming email. Covers email-type vals (the Email handler shape, attachment limits, the assigned val email address) and sending mail via std/email.

Its SKILL.md is about 650 tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

The repository describes itself as: A curated list of awesome OpenAI Codex / ChatGPT plugins, skills, and resources. The 1 Codex Marketplace. See live plugins at: https://hol.org/plugins/best-codex-plugins. The licence is Apache-2.0.

When your agent uses it

  • A val sends email
  • Is triggered by an incoming email

Example prompts

  • “/email”

What it can do on your machine

Read from SKILL.md and the folder at commit 78497e5. 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 typescript).

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

  • Network

    Hosts in commands or code, which the agent is likely to contact:

    • esm.town
    • docs.val.town

    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.

Context cost

Email loads about 653 tokens when it runs. Until then it costs about 55 tokens; SKILL.md has 231 words of instructions outside code blocks.

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

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 hashgraph-online/awesome-codex-plugins at commit 78497e5, republished under its Apache-2.0 licence (© hashgraph-online). 231 words, ~653 tokens.

Download SKILL.mdSave it as .claude/skills/email/SKILL.md (or your agent's skills folder).
name
email
description
Use when a val sends email, receives email, or is triggered by an incoming email. Covers email-type vals (the Email handler shape, attachment limits, the assigned val email address) and sending mail via std/email.
triggers
email, mail, inbox, send, sending, smtp, imap, attachment, message, notification

Email

Val Town supports both directions: vals can be triggered by incoming mail (email-type vals) and can send mail via std/email.

Receiving email — email-type vals

Email vals (fileType: "email") run when a message is delivered to the val's assigned address.

ts
// Learn more: https://docs.val.town/vals/email/
// Email type: {
//   from: string,
//   to: string[],
//   subject?: string,
//   text?: string,
//   html?: string,
//   attachments: File[],
//   headers: Record<string, string>
// }
export default async function (e: Email) {
  console.log(e.from, e.subject, e.text);
}

The file must have an export — export default for the handler.

Maximum 30MB per message, including attachments. Larger messages will be rejected.

Reading the assigned address

When you list files or create an email-type file, the response includes links.email — the address that triggers this val. Always read this from the API response. Never construct an email address yourself — the format is owned by the platform and may change.

Sending email — std/email

For outgoing mail, import from std/email:

ts
import { email } from "https://esm.town/v/std/email";

await email({
  to: "user@example.com",
  subject: "Hello",
  text: "Message body",
});

std/email exports email as the send function itself — call it directly (email({ ... })); there is no email.send method. It accepts the shape you'd expect: to, subject, text, html, plus from, cc, bcc, replyTo, attachments, and headers. If no to field is specified, it defaults to sending mail to the val owner's address.

Replying to an incoming message

Combine the two — read the inbound from in an email-type handler, then call email to reply:

ts
import { email } from "https://esm.town/v/std/email";

export default async function (e: Email) {
  await email({
    to: e.from,
    subject: `Re: ${e.subject ?? ""}`,
    text: "Got it, thanks!",
  });
}

Verifying changes

After editing an email-type val, use run_file with a sample Email payload to invoke the handler manually instead of waiting for a real incoming message. For send-only vals, run the script the same way and check get_logs for delivery errors.

© hashgraph-online, Apache-2.0. 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 plugins/val-town/plugins/skills/email of hashgraph-online/awesome-codex-plugins.

Open the folder on GitHubat commit 78497e5

Compare with similar skills

Email 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 compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Email this skillhashgraph-online/awesome-codex-plugins1.2k—~653Automated safety check: PassApache-2.0
Mailtrap Sending Emailssickn33/agentic-awesome-skills47k1 repos~2.8kAutomated safety check: PassMIT
Emailasgeirtj/system_prompts_leaks69k—~3.5kAutomated safety check: PassCC0-1.0
Emailscoreyhaines31/marketingskills54k1 repos~2.6kAutomated safety check: PassMIT
Mailtrap Email Integrationaffaan-m/ECC275k1 repos~955Automated safety check: PassMIT
Email Marketing Biblesickn33/agentic-awesome-skills47k—~8.7kAutomated safety check: PassMIT

Similar skills

  • Mailtrap Sending Emails

    sickn33/agentic-awesome-skills

    Configure or troubleshoot Mailtrap live email sending with Email API, SMTP, transactional streams, bulk streams, or batches.

    47k GitHub starsUsed in 1 repo~2.8k tokens
    Backend & APIsAuto-check passed
  • 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.6k 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.

    275k 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 yesterday
    Marketing & SEOAuto-check passed
  • Email Ops

    affaan-m/ECC

    Evidence-first mailbox triage, drafting, send verification, and sent-mail-safe follow-up workflow for ECC.

    275k GitHub starsUsed in 1 repo~1.1k tokens
    Writing & ContentAuto-check passed

More from hashgraph-online/awesome-codex-plugins

All 686 skills in this repo
  • Anime Reaction Gif

    hashgraph-online/awesome-codex-plugins

    Create original anime-style reaction stickers as looping GIFs and MP4 previews, using generated character pose sheets and timed key poses.

    1.2k GitHub stars~922 tokensUpdated today
    Auto-check passed
  • Calibredb

    hashgraph-online/awesome-codex-plugins

    Manage and query Calibre libraries with the calibredb CLI (local paths or Calibre Content server URLs).

    1.2k GitHub stars~1k tokensUpdated today
    Auto-check passed
  • Rust API Test Harness

    hashgraph-online/awesome-codex-plugins

    A skill your agent uses when adding, changing, testing, or debugging Rust HTTP APIs and services, especially when Codex needs black-box integration tests, random-port app startup, real database test…

    1.2k GitHub stars~1.7k tokensUpdated today
    Auto-check passed
  • Art

    hashgraph-online/awesome-codex-plugins

    Make a studio's game look like something at build time — a cover from a real frame of the game (free), painted covers, backdrops, textures and character plates from image models through the…

    1.2k GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • Game Balance Economy

    hashgraph-online/awesome-codex-plugins

    Balance game difficulty, resources, rewards, probability, progression, economies, and dominant strategies.

    1.2k GitHub stars~618 tokensUpdated today
    Auto-check passed
  • Manuscript Engagement Analytics

    hashgraph-online/awesome-codex-plugins

    Analyze nonfiction manuscripts for reader engagement signals, including heading-level word counts, slow starts, long slogs, weak takeaway titles, value pacing, beta-reader comment dropoff, and…

    1.2k GitHub stars~875 tokensUpdated today
    Auto-check passed

Questions about Email

What does Email do?

A skill your agent uses when a val sends email, receives email, or is triggered by an incoming email. Email is an agent skill from hashgraph-online/awesome-codex-plugins. Use when a val sends email, receives email, or is triggered by an incoming email.

When should I use Email?

Email fits situations like: A val sends email; is triggered by an incoming email.

How do I install Email in Claude Code?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill email -a claude-code`. Or copy the skill folder (plugins/val-town/plugins/skills/email in hashgraph-online/awesome-codex-plugins) into .claude/skills/email in your project. Claude Code loads it when a task matches its description.

How do I install Email in Codex?

Run `npx skills add hashgraph-online/awesome-codex-plugins --skill email -a codex`. Or copy the skill folder (plugins/val-town/plugins/skills/email in hashgraph-online/awesome-codex-plugins) into .agents/skills/email in your project. Codex loads it when a task matches its description.

Can I use Email 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 hashgraph-online/awesome-codex-plugins --skill email -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, .gemini/skills/email, .github/skills/email and .opencode/skills/email in your project.

What does Email need to run?

SKILL.md names no scripts, command-line tools or credentials: Email is instructions for the agent only.

Does Email access the network?

SKILL.md names 2 domains. In commands or code: esm.town and docs.val.town; the agent is likely to contact these when it follows the instructions. This is read from the text; nothing was executed.

Is Email 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 use?

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

How many tokens does Email use?

About 653 tokens (SKILL.md is roughly 2.6k 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?

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

Who maintains Email?

hashgraph-online (a GitHub organization) maintains it in hashgraph-online/awesome-codex-plugins, which has 1,242 GitHub stars. The repository holds 686 skills in this directory. The repository was last updated on October 8, 2026.

Source: hashgraph-online/awesome-codex-plugins on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.