Skills para agentes de WordPress: qué son, cuáles existen y cómo usarlos con Codex, Claude Code y más

Por Marcos Di Caprio | 8 min de lectura |

Tabla de Contenidos

Los asistentes de programación con IA ya pueden crear bloques, plugins, temas o automatizaciones de WordPress. El problema es que, sin un contexto técnico fiable, también pueden proponer APIs antiguas, saltarse comprobaciones de seguridad o romper la compatibilidad de un bloque. Para reducir ese margen de error, el proyecto WordPress/agent-skills reúne conocimientos especializados para que un agente de código trabaje siguiendo prácticas actuales de WordPress.

Es un proyecto público de la organización WordPress en GitHub, con licencia GPL-2.0-or-later. Sus contenidos se generan a partir de la documentación oficial de WordPress y Gutenberg, y han sido revisados y editados por contribuidores de WordPress. Conviene expresarlo con precisión: no es una función que venga incluida en WordPress Core ni un plugin que se instale en un sitio web. Es un conjunto de instrucciones para herramientas de IA que ayudan a desarrollar WordPress correctamente.

Primero: qué son un agente, un skill y un CLI

Un agente de programación es una IA que puede analizar un repositorio, proponer o editar archivos y ejecutar herramientas de desarrollo. Codex, Claude Code, GitHub Copilot, Cursor y otros entornos ofrecen este tipo de experiencia. El agente razona sobre una petición como «crea un bloque», pero necesita conocer las convenciones del proyecto y de la plataforma sobre la que trabaja.

Un skill es una carpeta portable que da ese contexto especializado al agente. Normalmente contiene un archivo SKILL.md con cuándo debe usarse, el procedimiento y cómo verificar el resultado; puede incluir también referencias más detalladas y scripts deterministas. No cambia la IA por otra, no instala nada en WordPress y no envía datos por sí solo: indica al agente qué comprobar y qué patrones aplicar cuando trabaja sobre código WordPress.

CLI significa command-line interface, o interfaz de línea de comandos. En este caso se refiere a ejecutar órdenes desde Terminal, PowerShell, la consola de VS Code o la terminal integrada de Codex/Claude Code. Es la vía más rápida para instalar los skills de forma reproducible.

Qué problemas resuelven

El conocimiento general de un modelo puede estar desactualizado o no conocer las decisiones concretas de tu repositorio. Los skills introducen una secuencia de trabajo: identificar si se trata de un plugin, un tema o un bloque; descubrir el tooling disponible; usar las APIs adecuadas; y ejecutar comprobaciones proporcionadas al cambio.

Con ello se evitan, entre otros, patrones anteriores a Gutenberg, fallos de seguridad en plugins, deprecaciones omitidas que producen bloques inválidos y comandos que ignoran la configuración existente del proyecto.

Son una ayuda, no una garantía. Sigue siendo recomendable revisar el diff, ejecutar pruebas y validar permisos, sanitización, escaping y compatibilidad antes de publicar un cambio.

Los skills disponibles y para qué sirve cada uno

  • wordpress-router: el punto de entrada. Clasifica el repositorio WordPress y dirige al flujo especializado que corresponde.
  • wp-project-triage: detecta automáticamente el tipo de proyecto, herramientas, pruebas y versiones para no asumir cómo está construido.
  • wp-block-development: para bloques Gutenberg: block.json, atributos, renderizado, migraciones/deprecaciones y scripts de vista.
  • wp-block-themes: para temas de bloques: theme.json, plantillas, partes, patrones y variaciones de estilos.
  • wp-plugin-development: arquitectura de plugins, hooks, activación, ajustes, persistencia de datos y seguridad.
  • wp-rest-api: rutas y controladores REST, validación, esquemas, autenticación, permisos y forma de las respuestas.
  • wp-interactivity-api: interactividad del frontend mediante directivas data-wp-*, stores y módulos.
  • wp-abilities-api: definición de capacidades, categorías, metadatos, exposición REST y comprobaciones de permisos para clientes.
  • wp-abilities-audit: revisa la superficie REST de un plugin y propone registros para la Abilities API.
  • wp-abilities-verify: comprueba que esos registros de Abilities API coinciden con las anotaciones declaradas.
  • wp-wpcli-and-ops: operaciones seguras con WP-CLI, automatización, multisite, cachés y search-replace.
  • wp-performance: medición, profiling, caché, consultas de base de datos y Server-Timing.
  • wp-phpstan: análisis estático con PHPStan en proyectos WordPress, incluidos tipos específicos y baselines.
  • wp-playground: WordPress Playground, ejecuciones CLI, previsualizaciones y snapshots.
  • wpds: componentes, tokens y patrones del WordPress Design System.
  • wp-plugin-directory-guidelines: criterios de las directrices del directorio oficial de plugins de WordPress.
  • blueprint: Blueprints de WordPress Playground para describir y repetir la preparación de un entorno.

No hace falta instalarlo todo. Para un plugin convencional suele tener sentido empezar por wordpress-router, wp-project-triage y wp-plugin-development; añade wp-rest-api si expones endpoints, o wp-block-development si el plugin incluye bloques. Instalar solo lo que necesitas mantiene el contexto más enfocado.

Instalación rápida desde la terminal

La opción recomendada por el repositorio es usar el paquete skills con npx. Desde la carpeta de tu proyecto, primero puedes consultar el catálogo:

npx skills add WordPress/agent-skills --list

Para instalar un skill concreto:

npx skills add WordPress/agent-skills --skill wp-plugin-development

Y para varios de una vez:

npx skills add WordPress/agent-skills --skill wordpress-router wp-project-triage wp-plugin-development wp-rest-api

El asistente de instalación preguntará el destino y el alcance. En instalaciones por proyecto, los archivos quedan en el directorio de instrucciones de la herramienta elegida y se pueden guardar en Git para que todo el equipo use las mismas pautas. Para que estén disponibles para tu usuario en todos los proyectos, añade --global:

npx skills add WordPress/agent-skills --skill wp-plugin-development --global

Antes de instalar en un repositorio compartido, revisa qué directorios se crearán y decide si deben versionarse. La regla práctica es sencilla: alcance global para preferencias personales; alcance de proyecto para reglas que el equipo debe compartir.

Instalación en Codex

Codex puede descubrir skills a nivel de proyecto. Si usas el instalador anterior, elige Codex como destino. El método explícito del repositorio oficial consiste en clonar, empaquetar e instalar:

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 --dest=../mi-proyecto-wordpress --targets=codex

Esto copia los skills seleccionados al área .codex/skills/ del proyecto. A partir de ahí, abre Codex desde ese proyecto y formula la petición normalmente: «revisa este plugin y corrige el endpoint REST» o «crea un bloque dinámico con atributos, renderizado seguro y pruebas». El agente elegirá los skills relevantes según sus instrucciones. Puedes instalar para varios clientes a la vez cambiando --targets, por ejemplo codex,claude,cursor.

Instalación en Claude Code

Claude Code reconoce skills globales en ~/.claude/skills/ y skills de proyecto en .claude/skills/. Para una instalación global desde el propio repositorio:

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 --skills=wp-playground,wp-block-development

Para que las instrucciones viajen con el repositorio, usa el destino del proyecto:

node shared/scripts/skillpack-install.mjs --dest=../mi-proyecto-wordpress --targets=claude --skills=wordpress-router,wp-plugin-development

VS Code/GitHub Copilot, Cursor y otras herramientas

El empaquetador está preparado para varios destinos. En un proyecto, --targets=vscode coloca los skills en .github/skills/, que es el directorio previsto para VS Code/GitHub Copilot; --targets=cursor usa .cursor/skills/. Ejemplo:

node shared/scripts/skillpack-install.mjs --dest=../mi-proyecto-wordpress --targets=codex,vscode,claude,cursor --skills=wordpress-router,wp-project-triage,wp-plugin-development

También existe instalación global específica para Cursor mediante --targets=cursor-global. El repositorio indica que los skills son compatibles con asistentes que admitan instrucciones a nivel de proyecto; si tu herramienta no cuenta con instalador propio, puedes copiar manualmente una carpeta de skills/ a su directorio de instrucciones.

Cómo usarlos bien en el día a día

  1. Instala el router y el triage, más los skills de tu área de trabajo.
  2. Abre la terminal o el agente en la raíz real del repositorio WordPress.
  3. Describe el resultado y las restricciones, no solo la implementación: «añade una ruta REST pública con validación, permisos y pruebas» es mejor que «haz una API».
  4. Pide al agente que inspeccione el proyecto antes de editar. El router y el triage están diseñados precisamente para eso.
  5. Revisa el cambio, ejecuta las pruebas o validaciones disponibles y pruébalo en un entorno seguro antes de desplegar.

Los skills no son una receta mágica, sino una forma de convertir buenas prácticas de WordPress en contexto operativo para una IA. Bien instalados, permiten que Codex, Claude Code, Copilot o Cursor entiendan mejor el terreno y trabajen de forma más consistente, auditable y alineada con la plataforma.

Fuentes y documentación oficial