Agent Skills

Las Agent Skills son un conjunto curado de «skills» reutilizables (paquetes de prompts y herramientas) que puedes añadir a la caja de herramientas de un agente de IA de programación para que trabaje de forma más eficaz en tareas de desarrollo relacionadas con WordPress.

Estandarizan cómo se indica a un agente de IA que ejecute flujos de trabajo habituales de WordPress, para que no tengas que volver a explicar el contexto cada vez (por ejemplo, cómo abordar el diseño de UI, el análisis estático, la caché, la optimización de la base de datos, etc.).

Su objetivo es que los agentes sean:

• Más seguros, porque incorporan buenas prácticas y salvaguardas
• Más consistentes y capaces de gestionar flujos de trabajo repetibles
• Más rápidos de poner en marcha, ya que los agentes obtienen el contexto de inmediato

Cómo se instalan

Las Agent Skills se incorporan al entorno de tu agente de una de estas dos formas:

1. Instalación local por proyecto: Las skills residen dentro del directorio de tu proyecto, de modo que todo el equipo del proyecto puede usar los mismos comportamientos.
2. Instalación global: Las skills residen en el directorio de configuración del agente de programación del usuario, de modo que se aplican a todos los proyectos.

En ambos casos, el agente de programación lee las skills desde el disco y las incorpora a sus instrucciones operativas.

Como las skills son archivos de contenido, el modelo de actualización más seguro es:

• Tratar las skills como recursos versionados
• Descargar actualizaciones periódicamente
• Revisar los diffs antes de desplegarlas de forma generalizada (especialmente en configuraciones compartidas o de equipo)

¿Qué Agent Skills de WordPress están disponibles?

La lista de Agent Skills disponibles puede cambiar, así que asegúrate de visitar el repositorio público para obtener la información más actualizada.

Hay skills para muchos fundamentos de WordPress, entre ellos:

• Desarrollo de bloques
• Desarrollo de plugins
• REST API
• WordPress Playground
• Rendimiento
• API de interactividad
• Diseño

Opciones de instalación

Hay varias formas de integrar agent-skills, según tu entorno y cómo prefieras gestionar las dependencias.

Opción 1: skills.sh

Si quieres una instalación rápida sin clonar ni compilar el repositorio manualmente, usa skills.sh, un asistente de instalación que facilita añadir archivos de agent skills a tu entorno local.

Requisito previo: Node.js (para poder ejecutar comandos npx)

1. Elige las skills que quieras instalar. También puedes ejecutar npx skills add https://github.com/WordPress/agent-skills --list para ver los nombres de todas las skills disponibles.
2. Instala las skills. Por ejemplo, lo siguiente instalaría wordpress-router, wp-project-triage, wp-block-development, wp-block-themes y wp-plugin-development 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

Para dirigirse a otro agente, sustituye --agent claude-code por tu agente (por ejemplo, --agent cursor). También puedes instalar para varios agentes pasando varios argumentos --agent.

Durante la instalación, se te preguntará si quieres instalar las skills de forma global o por proyecto. Puedes instalar las skills globalmente por defecto usando el argumento --global

Para eliminar una skill, ejecuta npx skills remove wp-block-themes, cambiando wp-block-themes por la skill que desees eliminar.

Para buscar actualizaciones, ejecuta npx skills check y después npx skills update para actualizar.

Al eliminar skills o ejecutar actualizaciones, usa el mismo ámbito que al instalarlas. Las instalaciones globales (--global) afectan a las skills a nivel de máquina, mientras que las instalaciones por proyecto afectan a las skills almacenadas junto a ese repositorio de código.

Opción 2:

Si necesitas control total, o vas a contribuir a las propias skills, clona el repositorio de skills y sigue los pasos manuales de compilación/instalación.

Elegir skills: skills «todas» vs «relevantes»

Puede que no necesites todas las Agent Skills disponibles para tu proyecto. En su lugar, puedes añadir skills en función de lo que estés haciendo. Por ejemplo:

• Desarrollo de bloques / Gutenberg: wp-block-development y wp-interactivity-api
• Temas de bloques/edición del sitio: wp-block-themes y wpds
• Desarrollo de plugins: wp-plugin-development y wp-abilities-api

Instala todas las skills cuando estés:

• Haciendo refactors amplios en varias áreas (bloques + temas + plugins), o
• Creando herramientas de plataforma en las que quieras la máxima cobertura.