agentmail — скилл для Claude Code: работа с AgentMail SDK
Скилл подсказывает агенту, как писать код на TypeScript или Python SDK AgentMail: почтовые ящики, письма, вебхуки, домены.
npx skills add agentmail-to/agentmail-skills --skill agentmail -a claude-codeЧто делает agentmail
AgentMail — почтовый API для ИИ-агентов, и этот скилл учит агента обращаться с его SDK, а не гадать по памяти. Внутри — краткий старт на TypeScript и Python, правила вызова методов и разбор типичных ошибок API. Агент создаёт ящик, отправляет письмо, читает ответ, настраивает вебхуки и домены.
У скилла есть справочники: отдельно по TypeScript, Python, администрированию доменов и DNS, вебхукам через Svix, WebSocket и разбору недоставленной почты (bounces, spam, blocked). Ключ хранится в переменной AGENTMAIL_API_KEY. Повторный вызов регистрации агента с тем же human_email перевыпускает ключ, и старый сразу перестаёт работать — это не идемпотентная операция, так что в коде её нельзя ставить в цикл проверки.
Скилл прямо ограничивает область: он для написания и ревью кода на SDK, а не для ручных операций с почтой, командной строки или настройки MCP. Нужен пакет agentmail — ставится через npm install agentmail или pip install agentmail. Отдельно учтите, что get_attachment отдаёт временную ссылку на cdn.agentmail.to, а не сами байты, и живёт она около часа: скачивать надо сразу.
Какие задачи решает
- создать почтовый ящик агента из кода
- отправить письмо и прочитать ответ с цитатами отдельно от подписи
- настроить домен и DNS для отправки почты
- подключить вебхуки и проверить подпись Svix
- разобраться, почему письмо агента не дошло
Примеры запросов агенту
- Напиши на Python создание ящика
supportи отправку письма через SDK agentmail - Перепиши этот код на TypeScript SDK agentmail и убери ошибку с удалением сообщения
- Почему письма агента не доходят — проверь по скиллу agentmail
Как установить agentmail
1Через Skills CLI (Vercel)
npx skills add agentmail-to/agentmail-skills --skill agentmail -a claude-code2Вручную: положить файлы
~/.claude/skills/agentmail/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/agentmail/
1Через Skills CLI (Vercel)
npx skills add agentmail-to/agentmail-skills --skill agentmail -a codex2Вручную: положить файлы
.agents/skills/agentmail/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add agentmail-to/agentmail-skills --skill agentmail -a cursor2Вручную: положить файлы
.cursor/skills/agentmail/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install agentmail-to/agentmail-skills agentmail2Вручную: положить файлы
.github/skills/agentmail/SKILL.md1Через Skills CLI (Vercel)
npx skills add agentmail-to/agentmail-skills --skill agentmail -a gemini-cli2Командой платформы
gemini skills install https://github.com/agentmail-to/agentmail-skills --path agentmailВручную: положить файлы
.devin/skills/agentmail/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add agentmail-to/agentmail-skills --skill agentmail -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о agentmail
Как установить agentmail в Claude Code?
Выполните npx skills add agentmail-to/agentmail-skills --skill agentmail -a claude-code. Скилл появится по пути ~/.claude/skills/agentmail/SKILL.md.
Что делает agentmail?
Даёт агенту инструкции по SDK AgentMail на TypeScript и Python: создание ящиков, отправка и чтение писем, домены, вебхуки, WebSocket и разбор недоставленной почты.
Нужен ли ключ API?
Да, ключ кладут в переменную окружения AGENTMAIL_API_KEY. Для регистрации агента из кода ключ не нужен: метод sign_up возвращает его в ответе.
