WordPress Agent Skills es el repositorio oficial que reúne instrucciones, referencias y herramientas para que los asistentes de IA trabajen mejor con el CMS. Su objetivo no es proporcionar otro prompt genérico, sino dar al modelo un procedimiento adaptado a WordPress: detectar el tipo de proyecto, consultar la documentación adecuada, aplicar prácticas actuales y comprobar el resultado antes de darlo por bueno.
El proyecto vive en la organización WordPress en GitHub y sirve para asistentes como Claude, Copilot, Codex o Cursor. Desde su publicación inicial ha crecido con nuevas áreas, entre ellas la Abilities API, los patrones, la guía para el directorio de plugins y los Blueprints de WordPress Playground. Por eso la versión que conviene consultar es siempre la del repositorio, no una copia pegada en un tutorial.
SKILL.md, referencias y scripts opcionales.Un asistente puede escribir PHP válido y aun así proponer una solución vieja, ignorar la estructura del repositorio o introducir un problema de permisos. En WordPress esto ocurre con facilidad porque conviven plugins tradicionales, bloques, temas basados en theme.json, APIs REST, código JavaScript y herramientas de compilación.
Agent Skills añade una capa de procedimiento. Primero ayuda a clasificar el proyecto y después dirige la tarea hacia la skill que corresponde. El agente no recibe un documento enorme para leerlo entero: carga la guía relacionada con lo que está haciendo y consulta sus referencias cuando las necesita. La documentación de Agents and Skills del Block Editor Handbook describe precisamente este enfoque progresivo, con instrucciones generales, guías específicas y documentación canónica enlazada.
El directorio skills del repositorio reúne actualmente estas 18 áreas. Algunas son de entrada y otras se ocupan de una parte muy concreta del desarrollo:
| Skill | Para qué sirve |
|---|---|
wordpress-router | Clasifica el repositorio y dirige la tarea al flujo apropiado. |
wp-project-triage | Detecta el tipo de proyecto, sus versiones y las herramientas disponibles. |
wp-block-development | Bloques Gutenberg, block.json, atributos, renderizado y deprecaciones. |
wp-block-themes | Temas de bloques, plantillas, patrones, variaciones y theme.json. |
wp-patterns | Creación y revisión de patrones de bloques. |
wp-plugin-development | Arquitectura de plugins, hooks, ajustes y seguridad. |
wp-plugin-directory-guidelines | Requisitos y buenas prácticas del directorio oficial de plugins. |
wp-rest-api | Rutas REST, esquemas, autenticación y respuestas. |
wp-interactivity-api | Interactividad en el frontend mediante directivas y stores. |
wp-abilities-api | Capacidades, permisos y autenticación para la Abilities API. |
wp-abilities-audit | Auditoría de la superficie REST de un plugin y propuesta de Abilities. |
wp-abilities-verify | Comprobación de registros de Abilities frente a sus anotaciones. |
wp-wpcli-and-ops | WP-CLI, automatización, multisite y operaciones de mantenimiento. |
wp-performance | Perfilado, caché, base de datos y Server-Timing. |
wp-phpstan | Análisis estático de PHP específico para proyectos WordPress. |
wp-playground | Entornos temporales, pruebas y snapshots con WordPress Playground. |
wpds | Uso del WordPress Design System. |
blueprint | Definición declarativa de entornos de WordPress Playground. |
La forma rápida de añadir una skill concreta es usar el instalador compatible con varios agentes:
npx skills add WordPress/agent-skills --skill wp-plugin-developmentPara consultar el catálogo antes de instalar nada puedes usar --list. El proyecto también permite preparar una instalación de prueba con --dry-run y elegir si la skill queda disponible para todo el usuario o solo para un repositorio. En una instalación por proyecto, las carpetas habituales son .codex/skills/, .claude/skills/, .cursor/skills/ y .github/skills/, según el asistente que utilices.
Si trabajas con varios agentes, el propio repositorio documenta una instalación dirigida a Codex, VS Code/Copilot, Claude y Cursor. Es una opción más limpia que copiar archivos a mano porque permite seleccionar los destinos y actualizar el paquete cuando cambien las instrucciones.
La pieza central es SKILL.md. Ahí se define cuándo debe activarse la guía, qué información tiene que reunir el asistente, qué pasos debe seguir y cómo verificar el resultado. Algunas skills añaden referencias para temas concretos y scripts que hacen comprobaciones repetibles, por ejemplo detectar archivos del proyecto o validar una estructura.
La diferencia con un prompt largo está en el reparto del contexto. El agente carga primero la orientación mínima y profundiza solo cuando la tarea lo exige. Para desarrollar un bloque, por ejemplo, puede combinar el router, la detección del proyecto y la guía de bloques; para revisar un plugin puede añadir las instrucciones de desarrollo, seguridad, PHPStan o Abilities API.
El repositorio incluye una declaración de autoría con IA. Según ese documento, la primera versión se generó con GPT-5.2 Codex a partir de documentación oficial de Gutenberg y WordPress, y después fue revisada por contribuidores y probada con asistentes como Claude, Copilot y Codex. Es una aclaración útil, pero no convierte las instrucciones en una garantía de que cualquier cambio sea correcto.
Antes de aceptar código generado, revisa las APIs que usa, los permisos, las consultas a la base de datos, la compatibilidad con la versión objetivo y las pruebas disponibles. Si el cambio afecta a una web en producción, trabaja con una copia o un entorno de pruebas y conserva una copia de seguridad. Nuestro artículo sobre el MCP Adapter de WordPress explica la parte relacionada con agentes que pueden interactuar con el propio sitio, mientras que Studio Code se centra en el trabajo local.
También conviene recordar que las skills evolucionan. La política de compatibilidad actual toma como referencia WordPress 7.0 o superior y PHP 7.4 o superior. Si el proyecto usa otra versión o una API en desarrollo, comprueba la documentación enlazada y pide al asistente que trabaje contra esa versión concreta.
¿Qué son las WordPress Agent Skills?
Son paquetes de instrucciones, referencias y herramientas opcionales que ayudan a los asistentes de IA a seguir procedimientos más adecuados para desarrollar en WordPress.
¿Con qué asistentes funcionan?
El repositorio está pensado para asistentes que admiten instrucciones a nivel de proyecto, como Codex, Claude, Cursor y GitHub Copilot. La compatibilidad concreta depende de cómo cada herramienta descubra y cargue las skills.
¿Qué versiones de WordPress y PHP contemplan?
La política de compatibilidad del repositorio apunta actualmente a WordPress 7.0 o superior y PHP 7.4 o superior.
¿Tengo que instalar las 18 skills?
No. Puedes instalar solo las que correspondan al proyecto. Para empezar suele bastar con el router, la detección del proyecto y la guía del área en la que vas a trabajar.
¿Sustituyen la documentación de WordPress?
No. Funcionan como una capa de procedimiento y deben apoyarse en la documentación oficial, el código del proyecto y las pruebas que haga el equipo.
Fuentes: repositorio oficial WordPress/agent-skills; política de compatibilidad; declaración de autoría; documentación de Agents and Skills.
