# plugin-validator

Субагент проверяет структуру плагина Claude: манифест, команды, агентов, скиллы, хуки и MCP-серверы. Пригодится перед публикацией.

- субагент · `type=agent` · Claude Code · ★ 44635
- Автор: Anthropic · официальный репозиторий Anthropic
- Лицензия: Apache-2.0 · policy=mirror · начало файла — в конце страницы
- Исходник: https://github.com/anthropics/claude-plugins-official/tree/HEAD/plugins/plugin-dev/agents/plugin-validator.md
- Обновлён: 2026-10-24
- HTML: https://affpapa.org/nevibecode/agents/plugin-validator

## Что делает

Вы просите проверить плагин, а агент идёт по списку: ищет `.claude-plugin/plugin.json`, разбирает JSON, смотрит обязательное поле `name` и формат kebab-case, проверяет `version`, `description`, `author`, `mcpServers`. Дальше — обход компонентов через Glob: `commands/**/*.md`, `agents/**/*.md`, `skills/*/SKILL.md`, `hooks/hooks.json`.

У каждого типа свои требования. У команд — YAML-фронтматтер и поле `description`, у агентов — имя из строчных букв и дефисов, блоки `<example>` в описании, допустимые значения `model` и `color`, у хуков — валидные имена событий и ссылки на скрипты через `${CLAUDE_PLUGIN_ROOT}`. Отдельно проверяются секреты в файлах и то, что MCP-серверы ходят по HTTPS или WSS.

Инструменты у агента простые: Read, Grep, Glob и Bash. Для разбора манифеста он берёт `jq`, так что без него проверка JSON пойдёт вручную. На выходе — отчёт с путями к файлам, разбивкой ошибок по критичности и подсказками по исправлению. Пустые каталоги и незнакомые поля в манифесте дают предупреждение, а не провал проверки.

## Установка

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

1. **Через маркетплейс плагинов**
В чате агента (не в терминале):
```text
/plugin install plugin-dev@claude-plugins-official
```

2. **Вручную: положить файлы**
- Файл: `.claude/agents/plugin-validator.md` — Для всех проектов — ~/.claude/agents/. Claude делегирует задачу сам по полю description или по @-упоминанию

### Codex

**Вручную: положить файлы**
- Файл: `.codex/agents/plugin-validator.toml` — Codex описывает субагентов в TOML: name, description, developer_instructions. Текст из Markdown перенесите в developer_instructions вручную. Для всех проектов — ~/.codex/agents/

### Cursor

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

Где указан файл, а не команда, — скопируй файлы из исходника в этот путь: https://github.com/anthropics/claude-plugins-official/tree/HEAD/plugins/plugin-dev/agents/plugin-validator.md

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

## Примеры запросов агенту
- Проверь структуру моего плагина перед публикацией
- Я поправил `.claude-plugin/plugin.json` — прогони валидацию
- Валидируй команды и хуки в моём плагине

## Похожие
- [Oh My Posh Validator](https://affpapa.org/nevibecode/mcp/oh-my-posh-validator.md) — MCP-сервер · ★ 23643
- [frontend-developer](https://affpapa.org/nevibecode/agents/voltagent-community-frontend-developer.md) — субагент · 40905 установок
- [dx-optimizer](https://affpapa.org/nevibecode/agents/dx-optimizer.md) — субагент · 1198 установок
- [mlops-engineer](https://affpapa.org/nevibecode/agents/voltagent-community-mlops-engineer.md) — субагент · 1009 установок
- [postgres-pro](https://affpapa.org/nevibecode/agents/postgres-pro.md) — субагент · 897 установок
- [agent-installer](https://affpapa.org/nevibecode/agents/agent-installer.md) — субагент · 363 установки
- [embedded-systems](https://affpapa.org/nevibecode/agents/embedded-systems.md) — субагент · 279 установок

Из того же набора: [anthropics/claude-plugins-official](https://affpapa.org/nevibecode/by/anthropics/claude-plugins-official.md) — 123 карточки

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

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