---
title: "WordPress Agent Skills: guía para programar con IA"
description: "Qué son las Agent Skills oficiales de WordPress, qué incluyen, cómo se instalan y qué debes revisar antes de dejar código en manos de un asistente de IA."
url: https://wpdirecto.com/wordpress-lanza-agent-skills-para-ensenar-a-la-ia-a-programar-mejor-en-su-ecosistema/
date: 2026-04-08
modified: 2026-09-09
author: "Editor WPDirecto"
image: https://wpdirecto.com/wp-content/uploads/2024/08/desarrolladores-colaborando-codigo.jpeg
categories: ["Actualidad"]
tags: ["agentes", "Claude", "codex", "github", "inteligencia artificial", "skills", "wordpress"]
type: post
lang: es
---

# WordPress Agent Skills: guía para programar con IA

**WordPress Agent Skills es el repositorio oficial que reúne instrucciones, referencias y herramientas para que los asistentes de IA trabajen mejor con el CMS.** Su objetivo no es proporcionar otro prompt genérico, sino dar al modelo un procedimiento adaptado a WordPress: detectar el tipo de proyecto, consultar la documentación adecuada, aplicar prácticas actuales y comprobar el resultado antes de darlo por bueno.

El proyecto vive en la organización [WordPress en GitHub](https://github.com/WordPress/agent-skills) y sirve para asistentes como Claude, Copilot, Codex o Cursor. Desde su publicación inicial ha crecido con nuevas áreas, entre ellas la Abilities API, los patrones, la guía para el directorio de plugins y los Blueprints de WordPress Playground. Por eso la versión que conviene consultar es siempre la del repositorio, no una copia pegada en un tutorial.

## Las claves de WordPress Agent Skills en 20 segundos

- Son carpetas reutilizables con un archivo `SKILL.md`, referencias y scripts opcionales.
- Ayudan a elegir el procedimiento correcto para bloques, temas, plugins, REST API, rendimiento o WP-CLI.
- El repositorio actual apunta a WordPress 7.0 o superior y PHP 7.4 o superior.
- No sustituyen la revisión humana, las pruebas ni la documentación oficial del proyecto.

## Qué problema intentan resolver

Un asistente puede escribir PHP válido y aun así proponer una solución vieja, ignorar la estructura del repositorio o introducir un problema de permisos. En WordPress esto ocurre con facilidad porque conviven plugins tradicionales, bloques, temas basados en `theme.json`, APIs REST, código JavaScript y herramientas de compilación.

Agent Skills añade una capa de procedimiento. Primero ayuda a clasificar el proyecto y después dirige la tarea hacia la skill que corresponde. El agente no recibe un documento enorme para leerlo entero: carga la guía relacionada con lo que está haciendo y consulta sus referencias cuando las necesita. La documentación de [Agents and Skills del Block Editor Handbook](https://developer.wordpress.org/block-editor/contributors/code/agents-and-skills/) describe precisamente este enfoque progresivo, con instrucciones generales, guías específicas y documentación canónica enlazada.

## Las 18 skills que aparecen en el repositorio

El directorio `skills` del repositorio reúne actualmente estas 18 áreas. Algunas son de entrada y otras se ocupan de una parte muy concreta del desarrollo:

| Skill | Para qué sirve |
| --- | --- |
| `wordpress-router` | Clasifica el repositorio y dirige la tarea al flujo apropiado. |
| `wp-project-triage` | Detecta el tipo de proyecto, sus versiones y las herramientas disponibles. |
| `wp-block-development` | Bloques Gutenberg, `block.json`, atributos, renderizado y deprecaciones. |
| `wp-block-themes` | Temas de bloques, plantillas, patrones, variaciones y `theme.json`. |
| `wp-patterns` | Creación y revisión de patrones de bloques. |
| `wp-plugin-development` | Arquitectura de plugins, hooks, ajustes y seguridad. |
| `wp-plugin-directory-guidelines` | Requisitos y buenas prácticas del directorio oficial de plugins. |
| `wp-rest-api` | Rutas REST, esquemas, autenticación y respuestas. |
| `wp-interactivity-api` | Interactividad en el frontend mediante directivas y stores. |
| `wp-abilities-api` | Capacidades, permisos y autenticación para la Abilities API. |
| `wp-abilities-audit` | Auditoría de la superficie REST de un plugin y propuesta de Abilities. |
| `wp-abilities-verify` | Comprobación de registros de Abilities frente a sus anotaciones. |
| `wp-wpcli-and-ops` | WP-CLI, automatización, multisite y operaciones de mantenimiento. |
| `wp-performance` | Perfilado, caché, base de datos y Server-Timing. |
| `wp-phpstan` | Análisis estático de PHP específico para proyectos WordPress. |
| `wp-playground` | Entornos temporales, pruebas y snapshots con WordPress Playground. |
| `wpds` | Uso del WordPress Design System. |
| `blueprint` | Definición declarativa de entornos de WordPress Playground. |

## Cómo instalar una skill sin cargar todo el repositorio

La forma rápida de añadir una skill concreta es usar el instalador compatible con varios agentes:

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

Para consultar el catálogo antes de instalar nada puedes usar `--list`. El proyecto también permite preparar una instalación de prueba con `--dry-run` y elegir si la skill queda disponible para todo el usuario o solo para un repositorio. En una instalación por proyecto, las carpetas habituales son `.codex/skills/`, `.claude/skills/`, `.cursor/skills/` y `.github/skills/`, según el asistente que utilices.

Si trabajas con varios agentes, el propio repositorio documenta una instalación dirigida a Codex, VS Code/Copilot, Claude y Cursor. Es una opción más limpia que copiar archivos a mano porque permite seleccionar los destinos y actualizar el paquete cuando cambien las instrucciones.

## Qué contiene una skill y cómo se usa

La pieza central es `SKILL.md`. Ahí se define cuándo debe activarse la guía, qué información tiene que reunir el asistente, qué pasos debe seguir y cómo verificar el resultado. Algunas skills añaden referencias para temas concretos y scripts que hacen comprobaciones repetibles, por ejemplo detectar archivos del proyecto o validar una estructura.

La diferencia con un prompt largo está en el reparto del contexto. El agente carga primero la orientación mínima y profundiza solo cuando la tarea lo exige. Para desarrollar un bloque, por ejemplo, puede combinar el router, la detección del proyecto y la guía de bloques; para revisar un plugin puede añadir las instrucciones de desarrollo, seguridad, PHPStan o Abilities API.

## Una ayuda para programar, no un piloto automático

El repositorio incluye una [declaración de autoría con IA](https://github.com/WordPress/agent-skills/blob/trunk/docs/ai-authorship.md). Según ese documento, la primera versión se generó con GPT-5.2 Codex a partir de documentación oficial de Gutenberg y WordPress, y después fue revisada por contribuidores y probada con asistentes como Claude, Copilot y Codex. Es una aclaración útil, pero no convierte las instrucciones en una garantía de que cualquier cambio sea correcto.

Antes de aceptar código generado, revisa las APIs que usa, los permisos, las consultas a la base de datos, la compatibilidad con la versión objetivo y las pruebas disponibles. Si el cambio afecta a una web en producción, trabaja con una copia o un entorno de pruebas y conserva una copia de seguridad. Nuestro artículo sobre el [MCP Adapter de WordPress](https://wpdirecto.com/wordpress-se-abre-a-los-agentes-de-ia-con-su-nuevo-mcp-adapter/) explica la parte relacionada con agentes que pueden interactuar con el propio sitio, mientras que [Studio Code](https://wpdirecto.com/studio-code-lleva-la-ia-al-desarrollo-local-de-wordpress/) se centra en el trabajo local.

También conviene recordar que las skills evolucionan. La [política de compatibilidad](https://github.com/WordPress/agent-skills/blob/trunk/docs/compatibility-policy.md) actual toma como referencia WordPress 7.0 o superior y PHP 7.4 o superior. Si el proyecto usa otra versión o una API en desarrollo, comprueba la documentación enlazada y pide al asistente que trabaje contra esa versión concreta.

## Preguntas frecuentes

**¿Qué son las WordPress Agent Skills?**
Son paquetes de instrucciones, referencias y herramientas opcionales que ayudan a los asistentes de IA a seguir procedimientos más adecuados para desarrollar en WordPress.

**¿Con qué asistentes funcionan?**
El repositorio está pensado para asistentes que admiten instrucciones a nivel de proyecto, como Codex, Claude, Cursor y GitHub Copilot. La compatibilidad concreta depende de cómo cada herramienta descubra y cargue las skills.

**¿Qué versiones de WordPress y PHP contemplan?**
La política de compatibilidad del repositorio apunta actualmente a WordPress 7.0 o superior y PHP 7.4 o superior.

**¿Tengo que instalar las 18 skills?**
No. Puedes instalar solo las que correspondan al proyecto. Para empezar suele bastar con el router, la detección del proyecto y la guía del área en la que vas a trabajar.

**¿Sustituyen la documentación de WordPress?**
No. Funcionan como una capa de procedimiento y deben apoyarse en la documentación oficial, el código del proyecto y las pruebas que haga el equipo.

Fuentes: [repositorio oficial WordPress/agent-skills](https://github.com/WordPress/agent-skills); [política de compatibilidad](https://github.com/WordPress/agent-skills/blob/trunk/docs/compatibility-policy.md); [declaración de autoría](https://github.com/WordPress/agent-skills/blob/trunk/docs/ai-authorship.md); [documentación de Agents and Skills](https://developer.wordpress.org/block-editor/contributors/code/agents-and-skills/).