From eb0b01de7b67e7ccc3db8f26201b9597887f0e2f Mon Sep 17 00:00:00 2001
From: teknium1 <teknium1@gmail.com>
Date: Sun, 8 Mar 2026 23:33:05 -0700
Subject: [PATCH] chore: move agentmail skill to optional-skills, add API key
 docs
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

AgentMail requires a third-party API key (free tier available, paid
plans from $20/mo) — not appropriate for bundled skills that show
up in every user's system prompt.

Added a Requirements section at the top with clear instructions
to add AGENTMAIL_API_KEY to ~/.hermes/.env. Streamlined setup steps
to avoid duplicating the key in both .env and config.yaml.
---
 .../email/agentmail/SKILL.md                  | 29 +++++++++----------
 1 file changed, 14 insertions(+), 15 deletions(-)
 rename {skills => optional-skills}/email/agentmail/SKILL.md (88%)

diff --git a/skills/email/agentmail/SKILL.md b/optional-skills/email/agentmail/SKILL.md
similarity index 88%
rename from skills/email/agentmail/SKILL.md
rename to optional-skills/email/agentmail/SKILL.md
index 7ef65894ad..8c35a16545 100644
--- a/skills/email/agentmail/SKILL.md
+++ b/optional-skills/email/agentmail/SKILL.md
@@ -10,6 +10,15 @@ metadata:
 
 # AgentMail — Agent-Owned Email Inboxes
 
+## Requirements
+
+- **AgentMail API key** (required) — sign up at https://console.agentmail.to (free tier: 3 inboxes, 3,000 emails/month; paid plans from $20/mo)
+- Add your key to `~/.hermes/.env`:
+  ```
+  AGENTMAIL_API_KEY=am_your_key_here
+  ```
+- Node.js 18+ (for the MCP server)
+
 ## When to Use
 Use this skill when you need to:
 - Give the agent its own dedicated email address
@@ -26,15 +35,10 @@ AgentMail gives the agent its own identity and inbox.
 
 ### 1. Get an API Key
 - Go to https://console.agentmail.to
-- Create an account (free tier: 3 inboxes, 3,000 emails/month)
-- Generate an API key (starts with `am_`)
-
-### 2. Configure Hermes
-Add to `~/.hermes/.env`:
-```
-AGENTMAIL_API_KEY=am_your_key_here
-```
+- Create an account and generate an API key (starts with `am_`)
+- Add it to `~/.hermes/.env` (see Requirements above)
 
+### 2. Configure MCP Server
 Add to `~/.hermes/config.yaml`:
 ```yaml
 mcp_servers:
@@ -42,15 +46,10 @@ mcp_servers:
     command: "npx"
     args: ["-y", "agentmail-mcp"]
     env:
-      AGENTMAIL_API_KEY: "am_your_key_here"
+      AGENTMAIL_API_KEY: "${AGENTMAIL_API_KEY}"
 ```
 
-### 3. Verify Node.js is installed
-```bash
-node --version  # Should be 18+
-```
-
-### 4. Restart Hermes
+### 3. Restart Hermes
 ```bash
 hermes
 ```