Как перестать спорить с нейросетями о правилах разработки в WordPress
Знакомая история: просишь Claude или Cursor набросать структуру нового блока для WordPress, а в ответ получаешь код десятилетней давности. Нейросеть уверенно предлагает использовать jQuery там, где давно нужен React, или «забывает» про регистрацию стилей в block.json. Это происходит потому, что базовые модели обучались на огромном массиве данных, включая легаси-код и устаревшие туториалы из 2015 года.
Команда разработчиков WordPress решила эту проблему изящно. Они создали репозиторий agent-skills — это набор инструкций и скриптов, которые буквально «обучают» вашего ИИ-ассистента актуальным стандартам разработки прямо в процессе работы.
Что это за проект
По сути, это официальный справочник навыков для ИИ. Если раньше нам приходилось копировать куски документации в промпт, то теперь можно один раз подключить нужный «скилл». Это пачка Markdown-файлов с четкими чек-листами и правилами, которые Claude, Cursor или Copilot подхватывают автоматически.
Проект закрывает дыру между тем, что нейросеть «думает» о WordPress, и тем, как движок работает в версии 6.7+.
На что способны эти навыки
Разработчики разбили знания на логические модули. Можно не тащить всё сразу, а выбрать только то, что нужно для конкретной задачи.
- Разработка блоков. Это, пожалуй, самая полезная часть. Скилл
wp-block-developmentзаставляет ассистента следовать современной структуре: правильно описывать атрибуты, обрабатывать депрекации (чтобы не ловить «Invalid block» в редакторе) и использовать серверный рендеринг там, где это уместно. - Работа с темами. Если вы переходите на Block Themes, навык
wp-block-themesподскажет ИИ, как работать сtheme.json, паттернами и вариациями стилей. Больше никаких попыток нейросети создать классическийheader.phpв блочной теме. - Интерактивность и API. Сюда включили инструкции по Interactivity API (те самые
data-wp-*директивы) и правильную настройку REST API. Ассистент начинает понимать разницу между простым Capability и сложной проверкой прав в контексте REST. - Инструментарий и статанализ. Есть даже навыки для работы с WP-CLI и настройки PHPStan специально под специфику WordPress.
Интересно, что сами эти инструкции изначально генерировались с помощью GPT-5.2 Codex на основе официальной документации Gutenberg, а затем вручную правились контрибьюторами ядра.
Как это работает технически
Каждый навык в репозитории — это не просто текст. Структура выглядит так:
SKILL.md— основная инструкция: когда использовать, какой алгоритм действий выбрать и как проверить результат.references/— глубокое погружение в детали, например, спецификацияblock.json.scripts/— небольшие JS-хелперы, которые ассистент может запустить для валидации или сканирования проекта.
Когда вы просите Claude Code или Cursor что-то сделать, они первым делом лезут в папку со скиллами, видят там правила игры и начинают выдавать код, который не стыдно отправить на код-ревью.
Как быстро подключить к работе
У проекта есть удобный скрипт для установки. Если вы пользуетесь Claude Code, можно поставить всё глобально:
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
Для Cursor или VS Code Copilot лучше устанавливать навыки прямо в репозиторий проекта. Скрипт сам создаст нужные папки (.cursor/skills/ или .github/skills/) и разложит файлы:
node shared/scripts/skillpack-install.mjs --dest=../my-wp-plugin --targets=cursor,vscode
Если не хочется возиться с консолью, можно просто вручную скопировать папку нужного навыка из skills/ в инструкции вашего ИИ-ассистента.
Чего не стоит ждать
Проект пока в версии v1. Это значит, что нейросеть всё еще может ошибаться, даже со скиллами. Инструкции помогают направить «мысль» ИИ в нужное русло, но не заменяют понимание архитектуры.
Кроме того, база знаний в основном заточена под современный стек Gutenberg. Если вы поддерживаете старый проект на классических темах и Advanced Custom Fields без блоков, профита будет меньше.
Если вы ежедневно используете ИИ для написания кода под WordPress, этот репозиторий — маст-хэв. Он экономит время на бесконечные правки галлюцинаций нейросети и помогает держать код в едином стиле с ядром системы.
Особенно полезно будет командам: можно закинуть эти скиллы в репозиторий проекта, и у всех разработчиков (и их ИИ-помощников) будет общая база правил. Попробовать точно стоит, тем более что установка занимает пару минут.