Agent skill

Agentmail

by Luciole-Studio in Luciole-Studio/Misaka-Agent

A skill your agent uses when an agent needs AgentMail CLI email inboxes.

Install Agentmail

skills CLI

$ npx skills add Luciole-Studio/Misaka-Agent --skill agentmail -a claude-code

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

GitHub CLI

$ gh skill install Luciole-Studio/Misaka-Agent agentmail --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/Luciole-Studio/Misaka-Agent.git skills-src && mkdir -p .claude/skills && cp -r skills-src/misaka/core/skills/assets/optional/email/agentmail .claude/skills/agentmail && 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/

Paste into Claude Code

Install the "agentmail" agent skill from https://github.com/Luciole-Studio/Misaka-Agent/tree/main/misaka/core/skills/assets/optional/email/agentmail into .claude/skills/agentmail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agentmail", then confirm the skill loads.

Claude Code copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

$skill-installer

$skill-installer install https://github.com/Luciole-Studio/Misaka-Agent/tree/main/misaka/core/skills/assets/optional/email/agentmail

Type this inside Codex. $skill-installer <name> installs a curated skill from openai/skills. The installer writes to $CODEX_HOME/skills (default ~/.codex/skills). Restart Codex if the skill does not show up.

skills CLI

$ npx skills add Luciole-Studio/Misaka-Agent --skill agentmail -a codex

Project install goes to .agents/skills/; add -g for ~/.codex/skills/.

GitHub CLI

$ gh skill install Luciole-Studio/Misaka-Agent agentmail --agent codex

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Luciole-Studio/Misaka-Agent.git skills-src && mkdir -p .agents/skills && cp -r skills-src/misaka/core/skills/assets/optional/email/agentmail .agents/skills/agentmail && rm -rf skills-src

Use ~/.agents/skills/ instead of .agents/skills for a personal install.

Codex skills documentation · loads skills from .agents/skills/

Paste into Codex

Install the "agentmail" agent skill from https://github.com/Luciole-Studio/Misaka-Agent/tree/main/misaka/core/skills/assets/optional/email/agentmail into .agents/skills/agentmail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agentmail", then confirm the skill loads.

Codex copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Luciole-Studio/Misaka-Agent --skill agentmail -a cursor

Project install goes to .agents/skills/; add -g for ~/.cursor/skills/.

GitHub CLI

$ gh skill install Luciole-Studio/Misaka-Agent agentmail --agent cursor

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Luciole-Studio/Misaka-Agent.git skills-src && mkdir -p .cursor/skills && cp -r skills-src/misaka/core/skills/assets/optional/email/agentmail .cursor/skills/agentmail && rm -rf skills-src

Use ~/.cursor/skills/ instead of .cursor/skills for a personal install.

Cursor skills documentation · loads skills from .cursor/skills/, .agents/skills/, .claude/skills/, .codex/skills/

Paste into Cursor

Install the "agentmail" agent skill from https://github.com/Luciole-Studio/Misaka-Agent/tree/main/misaka/core/skills/assets/optional/email/agentmail into .cursor/skills/agentmail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agentmail", then confirm the skill loads.

Cursor copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

gemini skills install

$ gemini skills install https://github.com/Luciole-Studio/Misaka-Agent.git --path misaka/core/skills/assets/optional/email/agentmail

--scope user (default) or --scope workspace; --path is the subfolder of the repo that holds the skill; --consent skips the security confirmation prompt.

skills CLI

$ npx skills add Luciole-Studio/Misaka-Agent --skill agentmail -a gemini-cli

Project install goes to .agents/skills/; add -g for ~/.gemini/skills/.

GitHub CLI

$ gh skill install Luciole-Studio/Misaka-Agent agentmail --agent gemini-cli

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Luciole-Studio/Misaka-Agent.git skills-src && mkdir -p .gemini/skills && cp -r skills-src/misaka/core/skills/assets/optional/email/agentmail .gemini/skills/agentmail && rm -rf skills-src

Use ~/.gemini/skills/ instead of .gemini/skills for a personal install, then run /skills reload.

Gemini CLI skills documentation · loads skills from .gemini/skills/, .agents/skills/

Paste into Gemini CLI

Install the "agentmail" agent skill from https://github.com/Luciole-Studio/Misaka-Agent/tree/main/misaka/core/skills/assets/optional/email/agentmail into .gemini/skills/agentmail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agentmail", then confirm the skill loads.

Gemini CLI copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

GitHub CLI

$ gh skill install Luciole-Studio/Misaka-Agent agentmail

Installs for Copilot at project scope by default; add --scope user for a personal install. Preview a skill first with gh skill preview. Needs GitHub CLI 2.90.0 or later (public preview).

skills CLI

$ npx skills add Luciole-Studio/Misaka-Agent --skill agentmail -a github-copilot

Project install goes to .agents/skills/; add -g for ~/.copilot/skills/.

Manual copy

$ git clone --depth 1 https://github.com/Luciole-Studio/Misaka-Agent.git skills-src && mkdir -p .github/skills && cp -r skills-src/misaka/core/skills/assets/optional/email/agentmail .github/skills/agentmail && rm -rf skills-src

Use ~/.copilot/skills/ instead of .github/skills for a personal install. Commit .github/skills so cloud agent and code review can use it.

GitHub Copilot skills documentation · loads skills from .github/skills/, .claude/skills/, .agents/skills/

Paste into GitHub Copilot

Install the "agentmail" agent skill from https://github.com/Luciole-Studio/Misaka-Agent/tree/main/misaka/core/skills/assets/optional/email/agentmail into .github/skills/agentmail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agentmail", then confirm the skill loads.

GitHub Copilot copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

skills CLI

$ npx skills add Luciole-Studio/Misaka-Agent --skill agentmail -a opencode

OpenCode documents no install command of its own. Project install goes to .agents/skills/; add -g for ~/.config/opencode/skills/.

GitHub CLI

$ gh skill install Luciole-Studio/Misaka-Agent agentmail --agent opencode

Project scope by default (.agents/skills/); add --scope user for a personal install.

Manual copy

$ git clone --depth 1 https://github.com/Luciole-Studio/Misaka-Agent.git skills-src && mkdir -p .opencode/skills && cp -r skills-src/misaka/core/skills/assets/optional/email/agentmail .opencode/skills/agentmail && rm -rf skills-src

Use ~/.config/opencode/skills/ instead of .opencode/skills for a personal install.

OpenCode skills documentation · loads skills from .opencode/skills/, .claude/skills/, .agents/skills/

Paste into OpenCode

Install the "agentmail" agent skill from https://github.com/Luciole-Studio/Misaka-Agent/tree/main/misaka/core/skills/assets/optional/email/agentmail into .opencode/skills/agentmail/ in this project. Copy the whole folder (SKILL.md and every file beside it), keep the folder name "agentmail", then confirm the skill loads.

OpenCode copies the folder itself, the same result as the manual copy. Check what it changed before you commit it.

Facts

Skill name: agentmail
GitHub stars: 125
Used in: 1 other repo
Token cost: ~781 tokens
SKILL.md length: 260 words
Files: 6 (incl. references)
Skills in repo: 76
Repo updated: Oct 7, 2026
First seen: Oct 7, 2026
Licence: MIT

At a glance

A skill your agent uses when an agent needs AgentMail CLI email inboxes.

Works in 4 steps: Install agentmail-cli@latest and verify… → If no API key is available, complete… → Use core.md for inbox, send, read,… → …
An agent needs AgentMail CLI email inboxes
SKILL.md covers When to Use, Prerequisites, How to Run and Quick Reference, plus 3 more sections
Calls npm; needs AGENTMAIL_API_KEY

What it does

Agentmail is an agent skill from Luciole-Studio/Misaka-Agent. Use when an agent needs AgentMail CLI email inboxes.

Its SKILL.md is about 780 tokens, which your agent loads only when the skill is triggered. The skill folder holds 6 other files, including reference files (for example `references/core.md`, `references/mcp.md` and `references/signup.md`).

It sits in Backend & APIs, covering Email management. It works with Model Context Protocol. The repository describes itself as: A multi-agent research system for the humanities and social sciences. The licence is MIT.

When your agent uses it

An agent needs AgentMail CLI email inboxes
Tasks that involve Email management

Example prompts

“/agentmail”

Requirements

Node.js
A credential in AGENTMAIL_API_KEY

Workflow steps

4 steps, taken from the first numbered list in SKILL.md.

Install agentmail-cli@latest and verify agentmail inboxes list --format json.
If no API key is available, complete signup.md.
Use core.md for inbox, send, read, reply, forward,
Add webhooks.md or

What it can do on your machine

Read from SKILL.md and the folder at commit 77871d7. 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
Shell commands in SKILL.md call:
- npm
From the folder's file list and the shell code blocks in SKILL.md.
Network
Links to these hosts (documentation or services it may open):
- agentmail.md
- agentmail.to
- console.agentmail.to
- docs.agentmail.to
From URLs in SKILL.md, links to its own repository left out.
Credentials
Names these keys or tokens, usually read from environment variables:
- AGENTMAIL_API_KEY
From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Agentmail loads about 781 tokens when it runs, and up to ~2.4k if it reads all its reference files. Until then it costs about 16 tokens; SKILL.md has 260 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it: ~16
When it runs · the whole SKILL.md, loaded when a task matches: ~781
With references · SKILL.md plus every file in references/, read only if the agent opens them: ~2.4k

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 Luciole-Studio/Misaka-Agent at commit 77871d7, republished under its MIT licence (© Luciole-Studio). 260 words, ~781 tokens.

Download SKILL.mdSave it as .claude/skills/agentmail/SKILL.md (or your agent's skills folder). This skill also uses 5 other files; get the full folder from GitHub.

name: agentmail
description: Use when an agent needs AgentMail CLI email inboxes.
version: 1.0.0
author: Haakam Aujla (Haakam21), AgentMail
license: MIT
platforms: linux, macos, windows
prerequisites.commands: agentmail

AgentMail Skill

AgentMail gives an agent its own email inbox for sending mail, receiving replies, completing email OTP flows, and running inbound email loops. Use it for agent-owned inboxes, not a user's existing IMAP/SMTP mailbox.

Use the agentmail CLI first. Use MCP only when the harness expects MCP tools; use REST only when the CLI is missing a required operation.

When to Use

The agent needs an email address it owns.
The task involves email OTP flows, replies, threads, labels, or attachments.
The agent needs webhook or WebSocket delivery for inbound mail.

Prerequisites

Run commands through the terminal tool.
Install the CLI:

bash

npm install -g agentmail-cli@latest

Export an API key:

bash

export AGENTMAIL_API_KEY="am_..."

No API key yet? Use signup.md.

How to Run

Use --format json whenever another command or script needs IDs.

bash

agentmail inboxes list --format json

Quick Reference

AgentMail agent reference: hosted copy.
AgentMail: product landing page.
Console: API keys and account management.
Docs: full product documentation.
signup.md: self-signup and OTP verification.
core.md: inboxes, messages, threads, labels, attachments.
webhooks.md: events to a public HTTPS server.
websockets.md: events to a local agent process.
mcp.md: MCP integration.

Procedure

Install agentmail-cli@latest and verify agentmail inboxes list --format json.
If no API key is available, complete signup.md.
Use core.md for inbox, send, read, reply, forward, label, thread, and attachment flows.
Add webhooks.md or websockets.md only when polling is not enough.

Pitfalls

Prefer AGENTMAIL_API_KEY over --api-key.
Never expose AGENTMAIL_API_KEY in prompts, logs, URLs, or committed files.
Use stable client_id values for retried create operations.
Prefer extracted_text or extracted_html for LLM input when present.
React to message.received, not messages the agent sent.

Verification

bash

agentmail inboxes list --format json

Files

SKILL.md and 5 other files (references) in misaka/core/skills/assets/optional/email/agentmail of Luciole-Studio/Misaka-Agent.

SKILL.md
references/core.md
references/mcp.md
references/signup.md
references/webhooks.md
references/websockets.md

Open the folder on GitHubat commit 77871d7

Used in 1 other repository

We found 1 copy of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in Luciole-Studio/Misaka-Agent, which our catalogue first saw on October 7, 2026.

NousResearch/hermes-agentoptional-skills/email/agentmail

Compare with similar skills

Agentmail 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.

Agentmail compared with similar skills
Skill	Stars	Used in	Tokens	Auto-check	Licence	Repo updated
Agentmail this skillLuciole-Studio/Misaka-Agent	125	1 repos	~781	Automated safety check: Pass	MIT	today
E2a Setuptokencanopy/e2a	192	—	~820	Automated safety check: Pass	Apache-2.0	yesterday
Mailagenthashgraph-online/awesome-codex-plugins	1.2k	—	~3.2k	Automated safety check: Pass	MIT	today
E2atokencanopy/e2a	192	—	~4.7k	Automated safety check: Pass	Apache-2.0	yesterday
Add Gmailsbusso/claudeclaw	194	—	~1.9k	Automated safety check: Pass	MIT	1 mo ago
E2a Doctortokencanopy/e2a	192	—	~994	Automated safety check: Pass	Apache-2.0	yesterday

Similar skills

E2a Setup
tokencanopy/e2a
A skill your agent uses when a user wants to connect or authorize the e2a MCP server, select or create an agent inbox, verify first-run readiness, or set up a custom email domain.
192 GitHub stars~820 tokensUpdated yesterday
Backend & APIsAuto-check passed
Mailagent
hashgraph-online/awesome-codex-plugins
Temporary inboxes for agent signup QA — create disposable addresses, wait for verification email, extract OTP or magic links.
1.2k GitHub stars~3.2k tokensUpdated today
Backend & APIsAuto-check passed
E2a
tokencanopy/e2a
A skill your agent uses when operating an already-connected e2a inbox over MCP: reading, composing, sending, replying, forwarding, handling attachments, managing contacts/outreach, scheduling mail…
192 GitHub stars~4.7k tokensUpdated yesterday
Productivity & AutomationAuto-check passed
Add Gmail
sbusso/claudeclaw
Add Gmail integration to ClaudeClaw. An agent skill from sbusso/claudeclaw.
194 GitHub stars~1.9k tokensUpdated 1 mo ago
Productivity & AutomationAuto-check passed
E2a Doctor
tokencanopy/e2a
A skill your agent uses when an existing e2a MCP connection, inbox, custom domain, protection policy, webhook, or message delivery is failing or unclear.
192 GitHub stars~994 tokensUpdated yesterday
Backend & APIsAuto-check passed
Gmail
sanjay3290/ai-skills
Interact with Gmail - search emails, read messages, send emails, create drafts, and manage labels.
430 GitHub stars~1.2k tokensUpdated 26 days ago
Productivity & AutomationAuto-check passed

Questions about Agentmail

What does Agentmail do?

A skill your agent uses when an agent needs AgentMail CLI email inboxes. Agentmail is an agent skill from Luciole-Studio/Misaka-Agent. Use when an agent needs AgentMail CLI email inboxes.

When should I use Agentmail?

Agentmail fits situations like: an agent needs AgentMail CLI email inboxes; tasks that involve Email management.

How do I install Agentmail in Claude Code?

Run `npx skills add Luciole-Studio/Misaka-Agent --skill agentmail -a claude-code`. Or copy the skill folder (misaka/core/skills/assets/optional/email/agentmail in Luciole-Studio/Misaka-Agent) into .claude/skills/agentmail in your project. Claude Code loads it when a task matches its description.

How do I install Agentmail in Codex?

Run `npx skills add Luciole-Studio/Misaka-Agent --skill agentmail -a codex`. Or copy the skill folder (misaka/core/skills/assets/optional/email/agentmail in Luciole-Studio/Misaka-Agent) into .agents/skills/agentmail in your project. Codex loads it when a task matches its description.

Can I use Agentmail 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 Luciole-Studio/Misaka-Agent --skill agentmail -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/agentmail, .gemini/skills/agentmail, .github/skills/agentmail and .opencode/skills/agentmail in your project.

What does Agentmail need to run?

Going by SKILL.md and its folder, Agentmail needs the command-line tools its instructions call (npm) and credentials named AGENTMAIL_API_KEY. Our summary lists: Node.js; A credential in AGENTMAIL_API_KEY.

Does Agentmail access the network?

SKILL.md names 4 domains. As links in the text: agentmail.md, agentmail.to, console.agentmail.to and docs.agentmail.to. This is read from the text; nothing was executed.

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

Agentmail is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Agentmail use?

About 781 tokens (SKILL.md is roughly 3.1k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 1.6k tokens, read only when the agent opens those files.

What are the alternatives to Agentmail?

Skills that share tags, products or a category with Agentmail: E2a Setup (tokencanopy/e2a, 192 stars), Mailagent (hashgraph-online/awesome-codex-plugins, 1.2k stars), E2a (tokencanopy/e2a, 192 stars) and Add Gmail (sbusso/claudeclaw, 194 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Agentmail?

Luciole-Studio (a GitHub organization) maintains it in Luciole-Studio/Misaka-Agent, which has 125 GitHub stars. The repository holds 76 skills in this directory. The repository was last updated on October 7, 2026.

Source: Luciole-Studio/Misaka-Agent on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.

Install Agentmail

Facts

At a glance

What it does

When your agent uses it

Example prompts

Requirements

Workflow steps

What it can do on your machine

Tool permissions

Runs code

Network

Credentials

Context cost

Safety

SKILL.md

AgentMail Skill

When to Use

Prerequisites

How to Run

Quick Reference

Procedure

Pitfalls

Verification

Files

Used in 1 other repository

Compare with similar skills

Similar skills

More from Luciole-Studio/Misaka-Agent

Related

Questions about Agentmail