La inteligencia artificial ya escribe código, propone refactors y se come tareas repetitivas que antes se llevaban media tarde, pero en WordPress sigue tropezando con un problema concreto: muchas veces genera patrones viejos, mezcla enfoques pre-Gutenberg con desarrollos modernos o se salta buenas prácticas críticas de seguridad, rendimiento y compatibilidad. Para atajar eso, el proyecto WordPress/agent-skills se está consolidando como una capa oficial de instrucciones reutilizables pensada para asistentes como Claude, Copilot, Codex o Cursor. La idea es fácil de explicar, aunque ambiciosa de ejecutar: enseñar a los agentes de IA a trabajar “a la manera WordPress”, con procedimientos, checklists y scripts que rebajen la cantidad de errores típicos.
El repositorio, que ya supera las 1.100 estrellas en GitHub, agrupa una colección de skills especializados para bloques, temas, plugins, REST API, Interactivity API, WP-CLI, rendimiento, PHPStan, Playground o el WordPress Design System, entre otros. La documentación pública también deja claro que estas skills están pensadas para WordPress 6.9+ y PHP 7.2.24+, y que funcionan con asistentes que soporten instrucciones a nivel de proyecto. Si llevas tiempo siguiendo el trabajo del core con MCP Adapter para abrir WordPress a los agentes de IA, esta pieza encaja en el mismo movimiento.
Lo interesante es que no son prompts sueltos, son paquetes estructurados. Cada skill incluye un archivo SKILL.md con instrucciones de uso, referencias temáticas y, cuando hace falta, scripts deterministas para evitar que el modelo “adivine” cosas como el tipo de repositorio, la versión de WordPress o el tooling del proyecto. Esa filosofía se nota también en la guía de autoría del repositorio, que insiste en mantener las skills cortas, procedimentales y apoyadas en verificaciones y escenarios de evaluación.
La propuesta tiene bastante lógica si miras el estado actual del desarrollo con asistentes. WordPress no es solo PHP ni solo Gutenberg: es un mundo enorme, con convenciones propias, APIs muy concretas y una transición todavía viva entre el viejo WordPress temático y el WordPress orientado a bloques y theme.json. Ahí es donde la IA suele patinar: genera soluciones aparentemente correctas, pero técnicamente desfasadas o difíciles de mantener. Lo hemos visto en muchas pruebas que han pasado por la redacción y, sinceramente, ni siquiera con modelos punteros se libra uno del problema.
Las Agent Skills intentan reducir ese problema guiando al asistente hacia rutas más fiables. En lugar de dejar que el modelo improvise, el sistema lo empuja a clasificar primero el repositorio, detectar si está ante un plugin, un bloque, un tema o una configuración híbrida, y después seguir la skill adecuada. Eso explica por qué el skill wordpress-router aparece como puerta de entrada lógica, acompañado por wp-project-triage, que ayuda a detectar tipo de proyecto, versiones y tooling disponible. La línea es la misma que sigue, por ejemplo, Claude Code WordPress Expert para auditar webs sin tocar el servidor: cuanto más estructurado el contexto, menos margen para que el modelo improvise.
También resulta importante que el propio proyecto haya publicado una AI Authorship Disclosure bastante transparente. Según esa documentación, las skills v1 fueron generadas con GPT-5.2 Codex (High Reasoning) a partir de documentación oficial de Gutenberg y WordPress, luego revisadas por contribuidores y probadas con asistentes como Claude, Copilot y Codex. No se vende como conocimiento revelado ni como trabajo puramente manual, sino como una capa híbrida de documentación destilada y revisada. Y, viendo cómo se mueve el mercado, ese tipo de transparencia se va a agradecer cada vez más.
La colección actual cubre buena parte del trabajo real que hacen desarrolladores, agencias y equipos de producto en WordPress. Esta tabla resume el enfoque de cada skill como guía rápida:
| Skill | Para qué sirve |
|---|---|
wordpress-router | Clasifica el repositorio y dirige al flujo correcto |
wp-project-triage | Detecta tipo de proyecto, versiones y tooling |
wp-block-development | Desarrollo de bloques Gutenberg, block.json, atributos y deprecaciones |
wp-block-themes | Temas de bloques, theme.json, plantillas, patrones y variaciones |
wp-plugin-development | Arquitectura de plugins, hooks, Settings API y seguridad |
wp-rest-api | Rutas y endpoints REST, esquema, autenticación y respuestas |
wp-interactivity-api | Interactividad frontend con data-wp-* y stores |
wp-abilities-api | Permisos basados en capacidades y autenticación en REST |
wp-wpcli-and-ops | WP-CLI, automatización, multisite y search-replace |
wp-performance | Perfilado, caché, base de datos y Server-Timing |
wp-phpstan | Análisis estático con PHPStan en proyectos WordPress |
wp-playground | Entornos efímeros de WordPress Playground |
wpds | WordPress Design System |
blueprint | Blueprints para configurar Playground de forma declarativa |
La utilidad real de esa colección aparece cuando agrupas las skills por escenarios. Para un artículo orientado a desarrolladores y equipos técnicos, esta segunda tabla resulta más práctica:
| Caso de uso | Skills recomendadas |
|---|---|
| Crear o mantener bloques Gutenberg | wordpress-router, wp-project-triage, wp-block-development, wp-phpstan |
| Desarrollar un tema moderno de bloques | wordpress-router, wp-project-triage, wp-block-themes, wpds |
| Construir o revisar un plugin | wordpress-router, wp-project-triage, wp-plugin-development, wp-abilities-api, wp-phpstan |
| Exponer endpoints o integrar headless | wordpress-router, wp-rest-api, wp-abilities-api, wp-performance |
| Automatizar tareas o trabajar con multisite | wordpress-router, wp-wpcli-and-ops, wp-performance, wp-playground |
| Probar cosas rápido sin tocar producción | wordpress-router, wp-playground, blueprint |
| Auditar rendimiento y cuellos de botella | wordpress-router, wp-performance, wp-wpcli-and-ops |
Uno de los puntos mejor resueltos del proyecto es la instalación. Se pueden meter de forma global para Claude Code, por proyecto en rutas como .claude/skills/, .codex/skills/, .cursor/skills/ o .github/skills/, e incluso existe instalación global para Cursor. La documentación oficial permite listar skills, hacer simulaciones con --dry-run e instalar solo las necesarias en lugar de cargar el paquete entero. Si te suena la mecánica, es porque va en línea con lo que ya hace MCP Content Manager Premium con sus 340 herramientas para que la IA gestione WordPress: dosificar el contexto en lugar de inflarlo.
Eso importa porque una de las críticas más habituales a este tipo de sistemas es que terminan saturando de contexto al asistente. Aquí WordPress parece haber entendido bien el problema: no se trata de meter “más prompt”, sino mejor contexto, más pegado a tareas concretas y más fácil de activar solo cuando toca. Si no, ya sabemos lo que pasa: el modelo se distrae, se inventa funciones que no existen y acabas debugueando a un asistente que tendría que estar ayudándote.
Quizá el mayor acierto del proyecto no sea la lista de skills, sino su filosofía de diseño. La guía de autoría insiste en varios principios muy razonables: usar scripts deterministas cuando el modelo tendría que adivinar, añadir escenarios de evaluación mínimos y obligar a que cada skill incluya secciones de verificación, fallos comunes y escalado. En un momento en que muchos asistentes aún tienen tendencia a “inventarse” el camino, ese enfoque puede marcar bastante la diferencia en proyectos WordPress reales. Va en la misma dirección que Studio Code llevando la IA al desarrollo local de WordPress: dejar de tratar al asistente como un autocompletado glorificado y empezar a tratarlo como una herramienta que sigue procedimientos.
En la práctica, esto significa que las skills no solo ayudan a escribir más rápido, también ayudan a escribir con menos ruido y menos deuda técnica. Y en WordPress, donde todavía conviven código muy antiguo y patrones muy modernos, esa disciplina vale más de lo que parece. Mi recomendación si trabajas con asistentes a diario: instala como mínimo wordpress-router, wp-project-triage y la skill que se ajuste a tu día a día (bloques, temas o plugins) y prueba a ver si baja el ratio de “esto no me cuadra” en las respuestas del modelo.
¿Qué son exactamente las WordPress Agent Skills?
Son paquetes reutilizables de instrucciones, checklists y scripts para asistentes de IA, pensados para que entiendan mejor cómo desarrollar en WordPress y sigan patrones actuales en bloques, temas, plugins, REST API, rendimiento y operaciones.
¿Funcionan solo con Claude Code?
No. La documentación del proyecto indica instalación para Claude, Codex, Cursor y VS Code/Copilot, además de compatibilidad general con asistentes que soporten instrucciones a nivel de proyecto.
¿Qué versiones de WordPress y PHP cubren estas skills?
La política de compatibilidad del repositorio apunta a WordPress 6.9+ y PHP 7.2.24+, que es la base mínima que toma el proyecto para su primera versión.
¿Están hechas solo por IA?
No exactamente. El proyecto publica una declaración de autoría donde explica que las skills v1 fueron generadas con GPT-5.2 Codex, revisadas y editadas por contribuidores de WordPress, y probadas con asistentes como Claude, Copilot y Codex.
¿Sustituyen a la documentación oficial de WordPress?
No. Son una capa adicional pensada para que el asistente trabaje mejor sobre WordPress, pero no reemplazan al Handbook de desarrolladores ni a la documentación de Gutenberg, theme.json, REST API o WP-CLI. Funcionan como complemento procedimental, no como referencia técnica.
