# optimize-agent-prompt

Скилл optimize-agent-prompt для Claude Code дорабатывает системные промпты Browserbase Agent API: запускает задачу, оценивает результат и меняет одну эвристику.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode, Windsurf (Devin Desktop), Claude.ai · 289 установок · ★ 3758 у репозитория
- Автор: browserbase
- Лицензия: MIT · policy=mirror · лицензия открытая, файл — в исходнике
- Исходник: https://github.com/browserbase/skills/tree/HEAD/skills/optimize-agent-prompt/SKILL.md
- Обновлён: 2026-09-29
- Проверка безопасности: автоматическая, 2026-11-16 (текст) — признаков вредоносного кода не нашли.
- HTML: https://affpapa.org/nevibecode/skills/optimize-agent-prompt

## Что делает

Держит задачу агента, схему результата, переменные и критерии оценки фиксированными, меняет только `systemPrompt`. Скрипт `optimize_agent_prompt.mjs` создаёт рабочее пространство (`init`), прогоняет итерацию (`run`), пишет логи сообщений, статус, трассировку сеанса в папку `runs/<label>/`, показывает траекторию (`inspect`) и сравнительную таблицу (`report`).

Нужен Node.js 18 или новее и ключ `BROWSERBASE_API_KEY`. Скрипт полагается только на встроенные модули Node.js. Проверка успеха оценивает статус `COMPLETED`, заполненные или явно nullable поля, регулярные выражения для известных фактов и предупреждения о выдуманных данных. Итерации останавливаются, когда промпт проходит два из трёх последних прогонов и один прогон — повтор без изменений. Без FFmpeg и Playwright: весь цикл идёт через Browserbase Agent API и Node.js.

Ограничение: скилл не гарантирует глобальный оптимум, только лучший промпт для протестированного распределения задач. Логи сеанса нужны, чтобы отличить редирект, 403, ошибку консоли от логической ошибки в вызове инструмента.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add browserbase/skills --skill optimize-agent-prompt -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add browserbase/skills --skill optimize-agent-prompt -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add browserbase/skills --skill optimize-agent-prompt -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install browserbase/skills skills/optimize-agent-prompt
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add browserbase/skills --skill optimize-agent-prompt -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/browserbase/skills --path skills/optimize-agent-prompt
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add browserbase/skills --skill optimize-agent-prompt -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/browserbase/skills/tree/HEAD/skills/optimize-agent-prompt/SKILL.md

## Когда брать
- довести промпт Browserbase Agent до стабильного прохождения задачи за минимум шагов
- понять, на каком ходе агент ошибся и какая эвристика это исправит
- собрать доказательства регрессии или улучшения из трассировок и логов браузера
- закрепить выигрышные изменения и откатить те, что не сработали

## Примеры запросов агенту
- Создай эксперимент `cart-extraction`, задача — вытянуть список товаров из корзины через Browserbase Agent
- Прогони итерацию с промптом `prompts/iteration-001.md`, лейбл `baseline`, покажи траекторию и сводку
- Сравни все итерации в `agent-prompt-optimization/cart-extraction`, построй таблицу с оценками

## Похожие
- [Browserbase](https://affpapa.org/nevibecode/mcp/browserbase-browserbase.md) — MCP-сервер · 433 установки
- [llm-application-dev-prompt-optimize](https://affpapa.org/nevibecode/skills/llm-application-dev-prompt-optimize.md) — скилл · 1 установка
- [prompt-optimize](https://affpapa.org/nevibecode/skills/prompt-optimize.md) — скилл · ★ 185 у репозитория
- [dspy-optimize-anything](https://affpapa.org/nevibecode/skills/dspy-optimize-anything.md) — скилл · ★ 125 у репозитория
- [Parallel Browser MCP](https://affpapa.org/nevibecode/mcp/parallel-browser-mcp.md) — MCP-сервер · ★ 41 у репозитория
- [optimize-memory-usage](https://affpapa.org/nevibecode/commands/optimize-memory-usage.md) — команда · 476 установок

Из того же набора: [browserbase/skills](https://affpapa.org/nevibecode/by/browserbase/skills.md) — 18 карточек

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