# create-headless-agent

Скилл create-headless-agent генерирует автономных агентов на TypeScript и Bun с библиотекой @openrouter/agent. Подходит для сборки CLI-утилит, веб-серверов и фоновых обработчиков без терминального интерфейса.

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

## Что делает

Скилл разворачивает проект автономного TypeScript-агента без графической оболочки и ANSI-разметки. В основе лежит библиотека `@openrouter/agent`, которая управляет циклом вызова моделей, выполнением инструментов и условиями остановки. Сгенерированный код принимает данные через аргументы командной строки, стандартный ввод, HTTP-сервер через `Bun.serve()` или протокол MCP.

Перед генерацией агент опрашивает разработчика: уточняет имя пакета, точки входа, нужные модули сессий и состав инструментов. Доступны серверные вызовы веб-поиска и загрузки страниц через OpenRouter, а также локальные операции с файлами и запуск системных команд.

Инструмент `Shell` требует явного флага `--allow-shell` при запуске и не изолирован внутри рабочего каталога. Для сборки окружения понадобятся установленный Bun версии 1.1 или выше и рабочий ключ `OPENROUTER_API_KEY`.

## Установка

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

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

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add OpenRouterTeam/skills --skill create-headless-agent -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add OpenRouterTeam/skills --skill create-headless-agent -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install OpenRouterTeam/skills skills/create-headless-agent
```

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

### Gemini CLI

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

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add OpenRouterTeam/skills --skill create-headless-agent -a opencode
```

### Claude.ai

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

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

## Когда брать
- собрать консольную утилиту на TypeScript для пакетной обработки данных
- настроить запуск агента как фонового сервиса с потоковым HTTP-ответом
- упаковать пайплайн с вызовами моделей OpenRouter в единый исполняемый CLI-бинарник
- подключить агент в виде MCP-сервера к существующему окружению

## Примеры запросов агенту
- Создай headless-агента на TypeScript для фонового парсинга документации через Bun
- Сгенерируй CLI-утилиту на базе @openrouter/agent с веб-поиском и сохранением сессий в JSONL
- Добавь MCP-сервер и HTTP-эндпоинт в архитектуру моего агента

## Похожие
- [npx-cli](https://affpapa.org/nevibecode/skills/npx-cli.md) — скилл · 309 установок
- [bun-runtime](https://affpapa.org/nevibecode/skills/secondsky-bun-runtime.md) — скилл · 435 установок
- [pinme-llm](https://affpapa.org/nevibecode/skills/pinme-llm.md) — скилл · 511 установок
- [vapi-bootstrap-framework](https://affpapa.org/nevibecode/skills/vapi-bootstrap-framework.md) — скилл · 314 установок
- [headless-caching-strategy](https://affpapa.org/nevibecode/skills/headless-caching-strategy.md) — скилл · 1100 установок
- [write-script-bun](https://affpapa.org/nevibecode/skills/write-script-bun.md) — скилл · ★ 18673 у репозитория

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

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