agentmail-cli — скилл для Claude Code: команды AgentMail из шелла
Учит агента работать с AgentMail через официальный CLI: инбоксы, письма, черновики, вебхуки и домены.
npx skills add agentmail-to/agentmail-skills --skill agentmail-cli -a claude-codeЧто делает agentmail-cli
Скилл описывает команды agentmail и порядок их вызова. Агент получает готовые примеры для инбоксов, сообщений и тредов, черновиков, pods, вебхуков и доменов — от agentmail inboxes list до agentmail domains verify --domain-id <domain_id>. Вложенный ресурс вызывается как вложенная подкоманда: inboxes messages, pods threads. Форма с двоеточием вроде inboxes:messages отклоняется в CLI 1.x, так что старые примеры из чужих инструкций не сработают.
Перед работой нужно поставить CLI и положить ключ в окружение: npm install -g agentmail-cli и export AGENTMAIL_API_KEY="am_...". Ключ можно переопределить флагом --api-key для отдельного вызова, а --base-url и --environment пригодятся, если API живёт не на стандартном хосте. Вывод переключается флагом --format: auto, pretty, json, jsonl, yaml, raw, explore — удобно, когда результат дальше разбирает скрипт.
Скилл не покрывает SDK-код, настройку MCP и адаптеры фреймворков — для этого он прямо не предназначен. Удаление инбокса необратимо, поэтому сначала проверьте, тот ли это --inbox-id. Для ответа нужен ID сообщения, а тело письма стоит подтянуть целиком, прежде чем на него опираться. Перед административной командой, которой нет в описании, запустите agentmail --help и справку по нужному ресурсу.
Какие задачи решает
- создать инбокс для агента поддержки
- прочитать и найти письмо в инбоксе
- отправить ответ на конкретное сообщение
- собрать черновик и отправить его после проверки
- выгрузить список тредов в JSON для скрипта
Примеры запросов агенту
- покажи все инбоксы через agentmail
- отправь письмо из инбокса support с темой Hello
- создай черновик ответа и покажи его перед отправкой
Как установить agentmail-cli
1Через Skills CLI (Vercel)
npx skills add agentmail-to/agentmail-skills --skill agentmail-cli -a claude-code2Вручную: положить файлы
~/.claude/skills/agentmail-cli/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/agentmail-cli/
1Через Skills CLI (Vercel)
npx skills add agentmail-to/agentmail-skills --skill agentmail-cli -a codex2Вручную: положить файлы
.agents/skills/agentmail-cli/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add agentmail-to/agentmail-skills --skill agentmail-cli -a cursor2Вручную: положить файлы
.cursor/skills/agentmail-cli/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install agentmail-to/agentmail-skills agentmail-cli2Вручную: положить файлы
.github/skills/agentmail-cli/SKILL.md1Через Skills CLI (Vercel)
npx skills add agentmail-to/agentmail-skills --skill agentmail-cli -a gemini-cli2Командой платформы
gemini skills install https://github.com/agentmail-to/agentmail-skills --path agentmail-cliВручную: положить файлы
.devin/skills/agentmail-cli/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add agentmail-to/agentmail-skills --skill agentmail-cli -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о agentmail-cli
Как установить agentmail-cli в Claude?
Выполните npx skills add agentmail-to/agentmail-skills --skill agentmail-cli -a claude-code. После этого скилл лежит в ~/.claude/skills/agentmail-cli/SKILL.md.
Что делает agentmail-cli?
Даёт агенту команды официального CLI AgentMail: список и создание инбоксов, чтение и поиск писем, отправка и ответы, черновики, pods, вебхуки и домены. Плюс флаги вывода в JSON, YAML и другие форматы.
Что нужно, чтобы скилл заработал?
Установленный CLI (npm install -g agentmail-cli) и ключ API в переменной AGENTMAIL_API_KEY. Для отдельного вызова ключ можно передать флагом --api-key.
