creating-internal-agents — скилл для Claude Code
Скилл creating-internal-agents для сборки внутреннего AI-агента в админке Medusa: модели, модульный сервис, рантайм на streamText(), NDJSON-стрим и страница чата.
лицензия не указана 500 установок ★ 237 обновлён 2026-10-21
npx skills add medusajs/medusa-agent-skills --skill creating-internal-agents -a claude-codeЧто делает creating-internal-agents
Скилл разбирает полный стек внутреннего агента для админки Medusa: модели AgentSession и AgentMessage, модульный сервис с клиентом Anthropic и методом stream(), рантайм на streamText(), POST-маршрут с NDJSON-стримом и страницу чата в админке. Данные агент трогает через MedusaExec: он пишет TypeScript и исполняет его, поэтому кастомный инструмент нужен только там, где кодом не обойтись, например для внешнего API с секретным ключом.
Сессии и сообщения общие для всех агентов, различаются они полем agent_type. Отдельные модели под каждый агент создавать не надо, а контейнер передаётся через experimental_context — прямой импорт сервисов в файлах инструментов даёт циклические зависимости.
Аутентификация обязательна. Маршруты живут в src/api/admin/ и принимают AuthenticatedMedusaRequest, потому что MedusaExec исполняет произвольный код с доступом к базе: открытый без проверки эндпоинт — это удалённое исполнение кода. После правки моделей нужны миграции npx medusa db:generate agent && npx medusa db:migrate. Перед кодом скилл требует загрузить референс под текущую задачу — reference/agent-setup.md, reference/streaming.md и остальные из таблицы.
Какие задачи решает
- собрать модели сессий и сообщений для чат-агента в админке Medusa
- поднять модульный сервис с клиентом Anthropic и методом
stream() - отдать ответ агента потоком NDJSON из POST-маршрута
- встроить страницу чата в админку Medusa
- дать агенту исполнять TypeScript через MedusaExec
Примеры запросов агенту
- Собери модуль
agentс моделямиAgentSessionиAgentMessageи полемagent_type - Сделай POST-маршрут в
src/api/admin/agent/сAuthenticatedMedusaRequestи NDJSON-стримом - Добавь страницу чата в админку для агента складских операций
Как установить creating-internal-agents
1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill creating-internal-agents -a claude-code2Вручную: положить файлы
~/.claude/skills/creating-internal-agents/SKILL.mdПапка скилла целиком; для одного проекта — .claude/skills/creating-internal-agents/
1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill creating-internal-agents -a codex2Вручную: положить файлы
.agents/skills/creating-internal-agents/SKILL.mdДля всех проектов — ~/.agents/skills/
1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill creating-internal-agents -a cursor2Вручную: положить файлы
.cursor/skills/creating-internal-agents/SKILL.mdCursor читает и .agents/skills/, и .claude/skills/
1GitHub CLI
gh skill install medusajs/medusa-agent-skills plugins/medusa-dev/skills/creating-internal-agents2Вручную: положить файлы
.github/skills/creating-internal-agents/SKILL.md1Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill creating-internal-agents -a gemini-cli2Командой платформы
gemini skills install https://github.com/medusajs/medusa-agent-skills --path plugins/medusa-dev/skills/creating-internal-agentsВручную: положить файлы
.devin/skills/creating-internal-agents/SKILL.mdСтарый путь .windsurf/skills/ тоже читается
Через Skills CLI (Vercel)
npx skills add medusajs/medusa-agent-skills --skill creating-internal-agents -a opencodeClaude.ai
Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills
По шагам, с командами для каждой платформы: Как установить скилл в Claude Code: пять способов
Вопросы о creating-internal-agents
Как установить creating-internal-agents в Claude Code?
Выполните npx skills add medusajs/medusa-agent-skills --skill creating-internal-agents -a claude-code. Файл скилла появится в ~/.claude/skills/creating-internal-agents/SKILL.md.
Что делает creating-internal-agents?
Проводит по всем слоям внутреннего агента в Medusa: модели диалога, модульный сервис, инструменты и системный промпт, стриминг NDJSON и UI в админке. Перед кодом просит загрузить референс под конкретную задачу.
Подойдёт ли скилл для чат-бота в витрине магазина?
Нет. Он рассчитан на агентов для продавцов и операторов с админ-аутентификацией; для клиентских ботов нужна другая схема — публичные маршруты, авторизация витрины и без MedusaExec.