# plugin-forge

Скилл для создания и управления плагинами Claude Code с правильной структурой, манифестами и интеграцией маркетплейса. Нужен, если вы собираете плагины для распространения или настраиваете компоненты команд и хуков.

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 3900 установок · ★ 2592
- Автор: softaworks
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/softaworks/agent-toolkit/tree/HEAD/skills/plugin-forge/SKILL.md
- Обновлён: 2026-03-05
- HTML: https://affpapa.org/nevibecode/skills/plugin-forge

## Что делает

plugin-forge помогает построить плагин с нуля: генерирует структуру папок, создаёт `plugin.json` и `marketplace.json`, регистрирует плагин в маркетплейсе. Скилл предоставляет скрипты `create_plugin.py` для создания плагина, `bump_version.py` для обновления версий по семантическому версионированию. Внутри примеры структур для фреймворков (React, Vue), утилит и доменных плагинов.

Рабочий процесс: запустить скрипт создания, добавить компоненты (команды в `commands/`, скиллы в `skills/`, агенты, хуки в `hooks.json`), проверить локально через `/plugin marketplace add` и `/plugin install`, обновить версии с помощью `bump_version.py`. Команды строятся по пути: `commands/namespace/command.md` становится `/namespace:command`.

Зависит от Python на машине разработчика. Версии нужно обновлять в обоих местах — в `plugin.json` и в `marketplace.json` — иначе плагин не установится корректно.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add softaworks/agent-toolkit --skill plugin-forge -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add softaworks/agent-toolkit --skill plugin-forge -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add softaworks/agent-toolkit --skill plugin-forge -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install softaworks/agent-toolkit plugin-forge
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add softaworks/agent-toolkit --skill plugin-forge -a gemini-cli
```

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

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add softaworks/agent-toolkit --skill plugin-forge -a opencode
```

### Claude.ai

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

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

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

## Примеры запросов агенту
- Создай новый плагин react-helpers для маркетплейса с автором 'John Doe' и ключевыми словами 'react,components'
- Обнови мажорную версию для плагина utils в маркетплейсе
- Добавь команду docs:generate в папку commands/docs плагина

## Похожие
- [create-plugin-scaffold](https://affpapa.org/nevibecode/skills/create-plugin-scaffold.md) — скилл · 1200 установок
- [marketplace-dev](https://affpapa.org/nevibecode/skills/marketplace-dev.md) — скилл · 695 установок
- [git-workflow-and-versioning](https://affpapa.org/nevibecode/skills/git-workflow-and-versioning.md) — скилл · 59500 установок
- [version-bump](https://affpapa.org/nevibecode/skills/version-bump.md) — скилл · 1800 установок
- [community-publish](https://affpapa.org/nevibecode/skills/community-publish.md) — скилл · 4000 установок
- [marketplace-publishing](https://affpapa.org/nevibecode/skills/marketplace-publishing.md) — скилл · 389 установок

Из того же набора: [softaworks/agent-toolkit](https://affpapa.org/nevibecode/by/softaworks/agent-toolkit.md) — 12 карточек

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

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