Agent Skills для WordPress: официальный набор скиллов для AI-ассистентов

· 4 мин чтения
wordpress skills ai-agents gutenberg php
📂 Исходный код на GitHub

Экспертные знания по WordPress для AI-ассистентов: блоки, темы, плагины и лучшие практики.

Agent Skills для 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.

Источник: https://github.com/WordPress/agent-skills