# plugin-authoring

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

- скилл · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · ★ 68
- Автор: ivan-magda
- Лицензия: MIT · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/ivan-magda/claude-code-plugin-template/tree/HEAD/plugins/plugin-development/skills/plugin-authoring/SKILL.md
- Обновлён: 2026-06-28
- HTML: https://affpapa.org/nevibecode/skills/plugin-authoring

## Что делает

Скилл разбирает структуру плагина и подсказывает, как работать с `.claude-plugin/plugin.json`, `marketplace.json`, `commands/`, `agents/`, `skills/` и `hooks/`. Он даёт схемы, шаблоны, чек-листы и сценарии для создания плагина, добавления компонентов, локального тестирования и поиска ошибок.

Рабочий процесс начинается с чтения текущей структуры репозитория. Затем скилл предлагает минимальное действие: создать каркас, проверить схему или подготовить ревью. Для операций есть слэш-команды `/plugin-development:init`, `/plugin-development:add-command`, `/plugin-development:add-skill`, `/plugin-development:add-agent`, `/plugin-development:add-hook`, `/plugin-development:validate` и `/plugin-development:test-local`.

По умолчанию скилл работает только на чтение и предлагает изменения до записи файлов. Перед проверкой хуков нужно учитывать права на запуск скриптов и использовать `${CLAUDE_PLUGIN_ROOT}` для путей; относительные пути ломаются после установки.

## Установка

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

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ivan-magda/claude-code-plugin-template --skill plugin-authoring -a claude-code
```

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

### Codex

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ivan-magda/claude-code-plugin-template --skill plugin-authoring -a codex
```

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

### Cursor

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ivan-magda/claude-code-plugin-template --skill plugin-authoring -a cursor
```

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

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install ivan-magda/claude-code-plugin-template plugin-authoring
```

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

### Gemini CLI

1. **Через Skills CLI (Vercel)**
```bash
npx skills add ivan-magda/claude-code-plugin-template --skill plugin-authoring -a gemini-cli
```

2. **Командой платформы**
```bash
gemini skills install https://github.com/ivan-magda/claude-code-plugin-template --path plugins/plugin-development/skills/plugin-authoring
```

### Windsurf (Devin Desktop)

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

### OpenCode

**Через Skills CLI (Vercel)**
```bash
npx skills add ivan-magda/claude-code-plugin-template --skill plugin-authoring -a opencode
```

### Claude.ai

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/ivan-magda/claude-code-plugin-template/tree/HEAD/plugins/plugin-development/skills/plugin-authoring/SKILL.md

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

## Примеры запросов агенту
- Создай каркас плагина `my-plugin` через `/plugin-development:init <name>`.
- Проверь манифест, каталоги и хуки через `/plugin-development:validate`.
- Добавь новый скилл с описанием момента его запуска через `/plugin-development:add-skill <name> <when-to-use>`.

## Похожие
- [find-skills](https://affpapa.org/nevibecode/skills/find-skills.md) — скилл · 4000000 установок
- [frontend-design](https://affpapa.org/nevibecode/skills/frontend-design.md) — скилл · 1025790 установок
- [grill-me](https://affpapa.org/nevibecode/skills/grill-me.md) — скилл · 1424476 установок
- [grill-with-docs](https://affpapa.org/nevibecode/skills/grill-with-docs.md) — скилл · 1219756 установок
- [improve-codebase-architecture](https://affpapa.org/nevibecode/skills/improve-codebase-architecture.md) — скилл · 1163035 установок
- [design-taste-frontend](https://affpapa.org/nevibecode/skills/design-taste-frontend.md) — скилл · 678700 установок

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

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