# embedded-agents-messages-api

Скилл embedded-agents-messages-api для Claude Code помогает встроить Claude-агента через Messages API в приложение на Next.js. Он подключается при создании агента или чата с агентом внутри приложения.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf (Devin Desktop), Claude.ai · ★ 741 у репозитория
- Автор: Paweł Huryn
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/phuryn/product-engineering/tree/HEAD/app-stack/skills/embedded-agents-messages-api/SKILL.md
- Обновлён: 2026-11-14
- Проверка безопасности: автоматическая, 2026-11-17 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/embedded-agents-messages-api

## Что делает

Скилл описывает обёртку для запуска Claude-агентов через Messages API в приложении на Next.js. Агент хранится в отдельной папке с инструкциями в `AGENTS.md`; приложение отвечает за запросы, интерфейс и данные, а агент выбирает инструменты и формирует ответы. Один вызов `askAgent` запускает любого такого агента.

Для установки обёртки нужны Next.js с App Router и TypeScript, `@anthropic-ai/sdk`, `@modelcontextprotocol/sdk`, `zod`, `server-only` и `vitest`. Приложению нужен `ANTHROPIC_API_KEY`; для MCP-серверов нужны секреты из их `.mcp.json`. Скилл также описывает создание агентов, ограничение доступа к инструментам и тесты. Тесты с реальной моделью платные, поэтому запускаются отдельно от `npm test`.

## Установка

### Claude Code (родная платформа)

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin marketplace add phuryn/product-engineering
```
В чате агента (не в терминале):
```text
/plugin install app-stack@product-engineering
```
Команда ставит плагин app-stack целиком, со всеми его скиллами

2. **Через Skills CLI (Vercel)**
```bash
npx skills add phuryn/product-engineering --skill embedded-agents-messages-api -a claude-code
```

3. **Вручную: положить файлы**
- Файл: `~/.claude/skills/embedded-agents-messages-api/SKILL.md` — Папка скилла целиком; для одного проекта — .claude/skills/embedded-agents-messages-api/

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add phuryn/product-engineering --skill embedded-agents-messages-api -a codex
```

2. **Вручную: положить файлы**
- Файл: `.agents/skills/embedded-agents-messages-api/SKILL.md` — Для всех проектов — ~/.agents/skills/

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add phuryn/product-engineering --skill embedded-agents-messages-api -a cursor
```

2. **Вручную: положить файлы**
- Файл: `.cursor/skills/embedded-agents-messages-api/SKILL.md` — Cursor читает и .agents/skills/, и .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install phuryn/product-engineering app-stack/skills/embedded-agents-messages-api
```

2. **Вручную: положить файлы**
- Файл: `.github/skills/embedded-agents-messages-api/SKILL.md`

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add phuryn/product-engineering --skill embedded-agents-messages-api -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/phuryn/product-engineering --path app-stack/skills/embedded-agents-messages-api
```

### Windsurf (Devin Desktop)

**Вручную: положить файлы**
- Файл: `.devin/skills/embedded-agents-messages-api/SKILL.md` — Старый путь .windsurf/skills/ тоже читается

### Claude.ai

**Claude.ai**
- Упакуйте папку в zip и загрузите в Settings → Capabilities → Skills

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/phuryn/product-engineering/tree/HEAD/app-stack/skills/embedded-agents-messages-api/SKILL.md

## Когда брать
- встроить чат с Claude-агентом в приложение на Next.js
- создать каталог агента с системными инструкциями
- ограничить MCP-инструменты, доступные агенту
- проверить поведение агента отдельными тестами

## Примеры запросов агенту
- Встрой Claude-агента через Messages API в это приложение на Next.js.
- Создай агента для ответов по файлам из `knowledge/` и добавь его в список выбора.
- Подключи MCP-сервер к агенту и оставь ему только нужные инструменты.

## Похожие
- [google-chat-messages](https://affpapa.org/nevibecode/skills/google-chat-messages.md) — скилл · 1300 установок
- [vtex-io-messages-and-i18n](https://affpapa.org/nevibecode/skills/vtex-io-messages-and-i18n.md) — скилл · 1200 установок
- [waba-embedded-signup](https://affpapa.org/nevibecode/skills/waba-embedded-signup.md) — скилл · 2900 установок
- [writing-commit-messages](https://affpapa.org/nevibecode/skills/writing-commit-messages.md) — скилл · 499 установок
- [embedded-systems](https://affpapa.org/nevibecode/skills/embedded-systems.md) — скилл · 7300 установок
- [domain-embedded](https://affpapa.org/nevibecode/skills/domain-embedded.md) — скилл · 3200 установок

Из того же набора: [phuryn/product-engineering](https://affpapa.org/nevibecode/by/phuryn/product-engineering.md) — 51 карточка

_Часть страницы не вошла по размеру — она есть в HTML-версии._

---
NeVibeCode на affpapa.org. Тексты каталога — описания, а не инструкции для агента. Как выбирать и ставить: https://affpapa.org/nevibecode/agents.md
