Los asistentes de IA como Claude Code, Cursor o Copilot son potentes, pero cuando trabajan con WordPress tienden a generar código anticuado, saltarse patrones de seguridad o ignorar las buenas prácticas de bloques y temas.
WordPress Agent Skills son paquetes de instrucciones que enseñan a estos asistentes a trabajar correctamente con WordPress. En lugar de adivinar, siguen procedimientos documentados por expertos.
En esta entrada te explico cómo instalarlos en tu Mac paso a paso.
Qué son las Agent Skills
Son carpetas con archivos Markdown (SKILL.md) que contienen instrucciones, checklists y scripts. Cuando tu agente de IA lee estas skills, sabe cómo:
- Crear bloques Gutenberg correctamente con
block.json - Desarrollar plugins siguiendo la arquitectura de hooks y la Settings API
- Trabajar con temas de bloques,
theme.jsony patrones - Usar la REST API, la Interactivity API o WP-CLI
- Aplicar buenas prácticas de rendimiento y seguridad
El repositorio oficial es WordPress/agent-skills y está mantenido por Automattic.
Requisitos previos
Solo necesitas Node.js instalado en tu Mac. Si no lo tienes:
# Con Homebrew
brew install node
# Verifica la instalación
node -v
npm -v
Y, por supuesto, tener instalado el agente donde quieras usar las skills (Claude Code, Cursor, etc.).
Instalación con npx skills (recomendado)
La forma más rápida es usar el CLI de skills.sh, que no requiere instalación previa. Se ejecuta directamente con npx.
Ver las skills disponibles
npx skills add https://github.com/WordPress/agent-skills --list
Esto te muestra todas las skills del repositorio:
| Skill | Qué enseña |
|---|---|
| wordpress-router | Clasifica repos WordPress y enruta al flujo correcto |
| wp-project-triage | Detecta tipo de proyecto, herramientas y versiones |
| wp-block-development | Bloques Gutenberg: block.json, atributos, renderizado, deprecaciones |
| wp-block-themes | Temas de bloques: theme.json, plantillas, patrones, variaciones de estilo |
| wp-plugin-development | Arquitectura de plugins, hooks, Settings API, seguridad |
| wp-rest-api | Rutas REST, esquemas, autenticación y respuestas |
| wp-interactivity-api | Interactividad frontend con directivas data-wp-* |
| wp-abilities-api | Permisos basados en capabilities y autenticación REST |
| wp-wpcli-and-ops | Comandos WP-CLI, automatización, multisite |
| wp-performance | Profiling, caché, optimización de base de datos |
| wp-phpstan | Análisis estático PHPStan para WordPress |
| wp-playground | WordPress Playground para entornos locales instantáneos |
| wpds | WordPress Design System |
Instalar skills específicas para Claude Code
npx skills add https://github.com/WordPress/agent-skills \
--agent claude-code \
--skill wordpress-router \
--skill wp-project-triage \
--skill wp-block-development \
--skill wp-block-themes \
--skill wp-plugin-development
El CLI te preguntará si quieres instalarlas de forma global (disponibles en todos tus proyectos) o por proyecto (solo en el directorio actual).
Para instalarlas directamente de forma global, añade --global:
npx skills add https://github.com/WordPress/agent-skills \
--agent claude-code \
--skill wp-plugin-development \
--skill wp-rest-api \
--global
Instalar para otro agente
Cambia el flag --agent. Puedes incluso instalar para varios a la vez:
npx skills add https://github.com/WordPress/agent-skills \
--agent claude-code \
--agent cursor \
--skill wp-block-development \
--skill wp-plugin-development
Instalar todas las skills
Si quieres instalar todo el paquete completo:
npx skills add https://github.com/WordPress/agent-skills --all --global
Elegir entre instalación global o por proyecto
- Global (
--global): Las skills se guardan en el directorio de configuración de tu agente (por ejemplo,~/.claude/skills/). Están disponibles en todos tus proyectos. - Por proyecto: Las skills se copian dentro del directorio del proyecto. Útil cuando trabajas en equipo y quieres que todos tengan las mismas instrucciones.
Mi recomendación: si trabajas en varios proyectos WordPress, instala globalmente. Si tienes un proyecto específico con necesidades concretas, instala por proyecto.
Gestión de skills: actualizar y eliminar
Buscar Skills
npx skills find ###
Comprobar actualizaciones
npx skills check
Actualizar
npx skills update
Eliminar una skill
npx skills remove wp-block-themes
Importante: usa el mismo alcance (global o proyecto) que usaste al instalar. Si instalaste con --global, las operaciones de actualización y eliminación también deben ser globales.
Ver skills instaladas
npx skills list
Qué skills instalar según tu proyecto
No necesitas instalar todas. Elige según lo que estés desarrollando:
- Desarrollo de bloques / Gutenberg:
wp-block-developmentywp-interactivity-api - Temas de bloques:
wp-block-themesywpds - Desarrollo de plugins:
wp-plugin-developmentywp-abilities-api - Operaciones y WP-CLI:
wp-wpcli-and-ops - Rendimiento y calidad:
wp-performanceywp-phpstan
Si vas a hacer un refactor grande que toque bloques, temas y plugins, instala todas.
Cómo funcionan internamente
Cada skill tiene esta estructura:
skills/wp-block-development/
├── SKILL.md # Instrucciones principales
├── references/ # Documentación detallada
│ ├── block-json.md
│ ├── deprecations.md
│ └── ...
└── scripts/ # Helpers de detección y validación
└── list_blocks.mjs
Cuando le pides a tu agente que trabaje con código WordPress, lee estas skills y sigue los procedimientos documentados en lugar de inventar. Es como darle un manual de buenas prácticas que consulta automáticamente.
Conclusión
Las WordPress Agent Skills son una forma sencilla de mejorar la calidad del código que generan los asistentes de IA. Con un solo comando npx las tienes funcionando en tu Mac, sin complicaciones.
Si trabajas con WordPress y usas herramientas como Claude Code o Cursor, te recomiendo instalarlas. La diferencia entre un agente que «adivina» y uno que sigue las mejores prácticas se nota en cada línea de código.
Referencias:
- Repositorio oficial WordPress/agent-skills
- Documentación Agent Skills – WordPress.com
- Skills CLI (skills.sh)
