La inteligencia artificial ya escribe código, propone refactors y acelera tareas repetitivas, pero en WordPress sigue tropezando con un problema muy concreto: demasiadas veces genera patrones viejos, mezcla enfoques pre-Gutenberg con desarrollos modernos o ignora buenas prácticas críticas de seguridad, rendimiento y compatibilidad. Para responder a eso, el proyecto WordPress/agent-skills ha empezado a consolidarse como una capa oficial de instrucciones reutilizables pensada para asistentes como Claude, Copilot, Codex o Cursor. Su objetivo es sencillo de entender, pero muy ambicioso en la práctica: enseñar a los agentes de IA a trabajar “a la manera WordPress”, con procedimientos, checklists y scripts que reduzcan errores comunes.
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. Además, la documentación pública 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.
Lo más interesante es que no se trata de prompts sueltos, sino de 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 también aparece en la guía de autoría del propio 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 se mira el estado actual del desarrollo con asistentes. WordPress no es solo PHP ni solo Gutenberg: es un ecosistema enorme, con convenciones propias, APIs muy concretas y una transición todavía viva entre el viejo WordPress temático y el WordPress más orientado a bloques y theme.json. Ahí es donde la IA suele fallar más: genera soluciones aparentemente correctas, pero técnicamente desfasadas o difíciles de mantener.
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.
También resulta relevante 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. Es un detalle importante porque no se presenta como conocimiento revelado ni como trabajo puramente manual, sino como una capa híbrida de documentación destilada y revisada.
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 se agrupan 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 instalar 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 también permite listar skills, hacer simulaciones con --dry-run e instalar solo las necesarias, en lugar de cargar el paquete completo.
Eso importa porque una de las críticas más habituales a este tipo de sistemas es que terminan sobrecargando de contexto al asistente. Aquí WordPress parece haber entendido bien el problema: no se trata de meter “más prompt”, sino de meter mejor contexto, más pegado a tareas concretas y más fácil de activar solo cuando toca.
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 tenga 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.
En la práctica, eso significa que estas skills no solo ayudan a escribir más rápido, sino 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 es más valiosa de lo que parece.
¿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.
