# extension-development

Скилл для разработки расширений Nimbalyst: собирает, ставит и перезагружает их прямо из запущенного приложения через MCP-инструменты.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 1971
- Автор: nimbalyst
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/nimbalyst/nimbalyst/tree/HEAD/packages/extensions/extension-dev-kit/claude-plugin/skills/extension-development/SKILL.md
- Обновлён: 2026-10-25
- HTML: https://affpapa.org/nevibecode/skills/extension-development

## Что делает

Скилл закрывает цикл разработки расширения Nimbalyst без ручных сборок в терминале. Агент вызывает MCP-инструменты `mcp__nimbalyst-extension-dev__extension_build`, `extension_install` и `extension_reload` — последний пересобирает и переустанавливает расширение за один шаг. Сборка идёт через скрипт `build` проекта: pnpm, если проект на pnpm, иначе npm.

Внутри есть и тестовые инструменты. `extension_test_run` гоняет Playwright-скрипты против запущенного Nimbalyst по CDP — можно передать инлайновый код или путь к `.spec.ts`. Плюс `extension_test_open_file` для открытия файла перед тестом, `extension_test_ai_tool` для прямого вызова обработчика AI-инструмента расширения и логи процессов для отладки.

Перед работой включите Extension Dev Tools в Settings > Advanced — без этого сборка и установка не пойдут. Каркас проекта удобнее создать через `File > New Extension Project` или команду `/new-extension` из Extension Developer Kit. Учтите: `extension_install` требует уже собранного расширения, а `restart_nimbalyst` агент должен вызывать только по вашей явной просьбе.

## Требования
- Работает с: Playwright

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add nimbalyst/nimbalyst --skill extension-development -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add nimbalyst/nimbalyst --skill extension-development -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add nimbalyst/nimbalyst --skill extension-development -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install nimbalyst/nimbalyst extension-development
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add nimbalyst/nimbalyst --skill extension-development -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/nimbalyst/nimbalyst --path packages/extensions/extension-dev-kit/claude-plugin/skills/extension-development
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add nimbalyst/nimbalyst --skill extension-development -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/nimbalyst/nimbalyst/tree/HEAD/packages/extensions/extension-dev-kit/claude-plugin/skills/extension-development/SKILL.md

## Когда брать
- собрать расширение Nimbalyst без запуска сборки вручную
- переустановить расширение после правки кода за один шаг
- проверить, загрузилось ли расширение и что оно отдаёт
- прогнать Playwright-тест против живого экземпляра приложения
- вызвать обработчик AI-инструмента расширения напрямую, минуя MCP-роутинг

## Примеры запросов агенту
- собери расширение в /path/to/my-extension и поставь его
- перезагрузи расширение com.nimbalyst.my-extension
- прогони тест из tests/basics.spec.ts и покажи, что упало

## Похожие
- [shopify-development](https://affpapa.org/nevibecode/skills/shopify-development.md) — скилл · 1900 установок
- [playwright-cli](https://affpapa.org/nevibecode/skills/playwright-cli.md) — скилл · 195700 установок
- [clerk-testing](https://affpapa.org/nevibecode/skills/clerk-testing.md) — скилл · 46300 установок
- [browser-trace](https://affpapa.org/nevibecode/skills/browser-trace.md) — скилл · 3000 установок
- [om-prepare-test-env](https://affpapa.org/nevibecode/skills/om-prepare-test-env.md) — скилл · 2900 установок
- [playwright-automation](https://affpapa.org/nevibecode/skills/playwright-automation.md) — скилл · 1900 установок

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

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

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