Agent Skills для WordPress: официальный набор скиллов для AI-ассистентов
📂 Исходный код на GitHubЭкспертные знания по WordPress для AI-ассистентов: блоки, темы, плагины и лучшие практики.
WordPress/agent-skills — официальный набор агентных скиллов от команды WordPress. Каждый скилл — это папка с инструкциями, справочниками и скриптами, которую вы подключаете к своему AI-ассистенту. После этого ассистент перестаёт угадывать, как писать код под WordPress, и работает по задокументированным процедурам: современный Gutenberg, безопасность, депрекации блоков.
Проект собрал около 2,4 тысячи звёзд на GitHub. Лицензия — GPL-2.0-or-later. Работает с любым ассистентом, который поддерживает инструкции уровня проекта: Claude Code, Copilot, Codex, Cursor и другими.
Зачем это нужно
Авторы описывают три типовые проблемы, которые решает набор:
- Ассистенты генерируют устаревшие шаблоны кода доэпохи Gutenberg.
- Пропускают критичные требования безопасности.
- Не добавляют депрекации блоков, из-за чего в редакторе появляется ошибка «Invalid block».
Скиллы дают ассистенту экспертные знания вместо догадок. Когда вы просите доработать плагин или тему, ассистент читает нужный скилл и действует по нему, а не выдумывает решение.
Что внутри: 20 скиллов
Все скиллы лежат в каталоге skills. Точка входа — wordpress-router: он определяет тип репозитория и направляет работу к нужному скиллу.
Навигация и проект
| Скилл | Что делает |
|---|---|
| wordpress-router | Классифицирует репозиторий и выбирает нужный сценарий работы |
| wp-project-triage | Определяет тип проекта, инструментарий и версии |
Блоки и темы
| Скилл | Что делает |
|---|---|
| wp-block-development | Блоки Gutenberg: block.json, атрибуты, рендеринг, депрекации |
| wp-block-themes | theme.json, шаблоны, паттерны, вариации стилей |
| wp-patterns | Создание и обновление блок-паттернов: стартовые страницы, шаблоны, раскладки Query Loop |
Плагины и API
| Скилл | Что делает |
|---|---|
| wp-plugin-development | Архитектура плагинов, хуки, Settings API, безопасность |
| wp-rest-api | Маршруты и эндпоинты, схемы, аутентификация, формат ответов |
| wp-interactivity-api | Интерактивность на фронтенде через директивы data-wp-* |
| wp-abilities-api | Права доступа через Abilities API и REST-аутентификация |
| wp-ability-development | Схемы способностей, CRUD-поведение, права |
| wp-abilities-audit | Аудит REST-поверхности плагина на регистрации в Abilities API |
| wp-abilities-verify | Проверка регистраций против заявленных аннотаций |
Инструментарий и производительность
| Скилл | Что делает |
|---|---|
| wp-wpcli-and-ops | WP-CLI, автоматизация, мультисайт, search-replace |
| wp-performance | Профилирование, кеширование, оптимизация базы данных, Server-Timing |
| wp-phpstan | Статический анализ PHPStan для WordPress |
| wp-playground | Маршрутизация Playground, запуск из CLI, превью в браузере, снапшоты |
| blueprint | Playground Blueprints для декларативной настройки окружения |
| wp-env | Локальная разработка с @wordpress/env, WP-CLI, Xdebug, разбор проблем |
Дизайн и каталог плагинов
| Скилл | Что делает |
|---|---|
| wpds | WordPress Design System — дизайн-система WordPress |
| wp-plugin-directory-guidelines | Правила каталога плагинов WordPress |
Структура скилла
Каждый скилл — самодостаточная папка из трёх частей:
SKILL.md— главная инструкция, которую читает ассистент.references/— подробные справочники по отдельным темам.scripts/— детерминированные скрипты-помощники, если нужны точные вычисления вместо генерации.
Установка
Самый быстрый способ — одна команда через npx:
npx skills add WordPress/agent-skills --skill wp-plugin-development
Полезные флаги:
--list— показать все доступные скиллы.-gили--global— установить глобально в~/.claude/skills/или~/.cursor/skills/.- Несколько имён скиллов в одной команде — установит их разом.
Область установки. При проектной установке скиллы попадают в .claude/skills/, .github/skills/, .cursor/skills/, .codex/skills/. Если скилл есть и в проекте, и глобально, приоритет у версии из проекта.
Альтернатива — клонировать репозиторий и собрать скиллы локально:
git clone https://github.com/WordPress/agent-skills.git
cd agent-skills
node shared/scripts/skillpack-build.mjs --clean
node shared/scripts/skillpack-install.mjs --global
Скрипт skillpack-install.mjs принимает опции:
--dest— путь к целевому проекту.--targets— список ассистентов: codex, vscode, claude, cursor, antigravity. Antigravity подключается только явно.--skills— выбор конкретных скиллов.--listи--dry-run— показать список или выполнить пробный прогон без записи.
Есть и совсем ручной способ: скопировать папки нужных скиллов в каталог инструкций вашего ассистента.
Как это работает на практике
Отдельной настройки не требуется. Вы устанавливаете скиллы и работаете как обычно: просите ассистента добавить поле настроек в плагин или собрать новый блок. Ассистент сам определяет, какой скилл относится к задаче, читает его и действует по описанной процедуре — вместо догадок задокументированный порядок шагов, от структуры block.json до правил безопасности и депрекаций. Маршрутизатор wordpress-router в начале работы классифицирует репозиторий и подсказывает, какие скиллы подключить к текущей задаче.
Требования
- WordPress 7.0+ (PHP 7.4.0+).
- Любой AI-ассистент с поддержкой инструкций уровня проекта.
Как набор создавался
Авторы честно раскрывают происхождение материала. Скиллы сгенерированы моделью GPT-5.2 Codex по официальной документации WordPress и Gutenberg. Затем контрибьюторы WordPress проверили и отредактировали результат вручную. Текущая версия — первая, и её качество будет расти вместе с вкладом сообщества.
Для контрибьюторов в репозитории есть два скрипта: scaffold-skill.mjs создаёт каркас нового скилла, а validate-skills.mjs проверяет метаданные. Сценарии оценки скиллы проходят вручную — валидатор их не запускает.
Кому подойдёт
Набор стоит подключить, если вы пишете плагины или темы под современный WordPress с помощью AI-ассистента. Он заменяет разрозненные знания модели на проверенные процедуры: как зарегистрировать блок с депрекациями, как устроены права в Abilities API, как правильно оформить плагин для каталога WordPress. Отдельный бонус — скиллы не привязаны к одному ассистенту: один и тот же набор работает в Claude Code, Cursor, Codex и Copilot.