{"id":4516,"date":"2026-02-26T13:27:21","date_gmt":"2026-02-26T12:27:21","guid":{"rendered":"https:\/\/davidperezgar.com\/?p=4516"},"modified":"2026-02-26T13:39:57","modified_gmt":"2026-02-26T12:39:57","slug":"como-instalar-wordpress-agent-skills-en-mac","status":"publish","type":"post","link":"https:\/\/davidperezgar.com\/es\/como-instalar-wordpress-agent-skills-en-mac\/","title":{"rendered":"C\u00f3mo instalar WordPress Agent Skills en Mac"},"content":{"rendered":"\n<p class=\"wp-block-paragraph\">Los asistentes de IA como Claude Code, Cursor o Copilot son potentes, pero cuando trabajan con WordPress tienden a generar c\u00f3digo anticuado, saltarse patrones de seguridad o ignorar las buenas pr\u00e1cticas de bloques y temas.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>WordPress Agent Skills<\/strong> son paquetes de instrucciones que ense\u00f1an a estos asistentes a trabajar correctamente con WordPress. En lugar de adivinar, siguen procedimientos documentados por expertos.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">En esta entrada te explico c\u00f3mo instalarlos en tu Mac paso a paso.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\">Qu\u00e9 son las Agent Skills<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Son carpetas con archivos Markdown (SKILL.md) que contienen instrucciones, checklists y scripts. Cuando tu agente de IA lee estas skills, sabe c\u00f3mo:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li class=\"\">Crear bloques Gutenberg correctamente con <code>block.json<\/code><\/li>\n\n\n\n<li class=\"\">Desarrollar plugins siguiendo la arquitectura de hooks y la Settings API<\/li>\n\n\n\n<li class=\"\">Trabajar con temas de bloques, <code>theme.json<\/code> y patrones<\/li>\n\n\n\n<li class=\"\">Usar la REST API, la Interactivity API o WP-CLI<\/li>\n\n\n\n<li class=\"\">Aplicar buenas pr\u00e1cticas de rendimiento y seguridad<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">El repositorio oficial es <a href=\"https:\/\/github.com\/WordPress\/agent-skills\" target=\"_blank\" rel=\"noopener\">WordPress\/agent-skills<\/a> y est\u00e1 mantenido por Automattic.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\">Requisitos previos<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Solo necesitas <strong>Node.js<\/strong> instalado en tu Mac. Si no lo tienes:<\/p>\n\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><code class=\"\"># Con Homebrew\nbrew install node\n\n# Verifica la instalaci\u00f3n\nnode -v\nnpm -v\n<\/code><\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Y, por supuesto, tener instalado el agente donde quieras usar las skills (Claude Code, Cursor, etc.).<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\">Instalaci\u00f3n con npx skills (recomendado)<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">La forma m\u00e1s r\u00e1pida es usar el CLI de <a href=\"https:\/\/skills.sh\/\" target=\"_blank\" rel=\"noopener\">skills.sh<\/a>, que no requiere instalaci\u00f3n previa. Se ejecuta directamente con <code>npx<\/code>.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Ver las skills disponibles<\/h3>\n\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><code class=\"\">npx skills add https:\/\/github.com\/WordPress\/agent-skills --list\n<\/code><\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Esto te muestra todas las skills del repositorio:<\/p>\n\n\n\n<figure class=\"wp-block-table\"><table class=\"has-fixed-layout\"><thead><tr><th>Skill<\/th><th>Qu\u00e9 ense\u00f1a<\/th><\/tr><\/thead><tbody><tr><td><strong>wordpress-router<\/strong><\/td><td>Clasifica repos WordPress y enruta al flujo correcto<\/td><\/tr><tr><td><strong>wp-project-triage<\/strong><\/td><td>Detecta tipo de proyecto, herramientas y versiones<\/td><\/tr><tr><td><strong>wp-block-development<\/strong><\/td><td>Bloques Gutenberg: <code>block.json<\/code>, atributos, renderizado, deprecaciones<\/td><\/tr><tr><td><strong>wp-block-themes<\/strong><\/td><td>Temas de bloques: <code>theme.json<\/code>, plantillas, patrones, variaciones de estilo<\/td><\/tr><tr><td><strong>wp-plugin-development<\/strong><\/td><td>Arquitectura de plugins, hooks, Settings API, seguridad<\/td><\/tr><tr><td><strong>wp-rest-api<\/strong><\/td><td>Rutas REST, esquemas, autenticaci\u00f3n y respuestas<\/td><\/tr><tr><td><strong>wp-interactivity-api<\/strong><\/td><td>Interactividad frontend con directivas <code>data-wp-*<\/code><\/td><\/tr><tr><td><strong>wp-abilities-api<\/strong><\/td><td>Permisos basados en capabilities y autenticaci\u00f3n REST<\/td><\/tr><tr><td><strong>wp-wpcli-and-ops<\/strong><\/td><td>Comandos WP-CLI, automatizaci\u00f3n, multisite<\/td><\/tr><tr><td><strong>wp-performance<\/strong><\/td><td>Profiling, cach\u00e9, optimizaci\u00f3n de base de datos<\/td><\/tr><tr><td><strong>wp-phpstan<\/strong><\/td><td>An\u00e1lisis est\u00e1tico PHPStan para WordPress<\/td><\/tr><tr><td><strong>wp-playground<\/strong><\/td><td>WordPress Playground para entornos locales instant\u00e1neos<\/td><\/tr><tr><td><strong>wpds<\/strong><\/td><td>WordPress Design System<\/td><\/tr><\/tbody><\/table><\/figure>\n\n\n\n<h3 class=\"wp-block-heading\">Instalar skills espec\u00edficas para Claude Code<\/h3>\n\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><code class=\"\">npx skills add https:\/\/github.com\/WordPress\/agent-skills \\\n  --agent claude-code \\\n  --skill wordpress-router \\\n  --skill wp-project-triage \\\n  --skill wp-block-development \\\n  --skill wp-block-themes \\\n  --skill wp-plugin-development\n<\/code><\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">El CLI te preguntar\u00e1 si quieres instalarlas <strong>de forma global<\/strong> (disponibles en todos tus proyectos) o <strong>por proyecto<\/strong> (solo en el directorio actual).<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">Para instalarlas directamente de forma global, a\u00f1ade <code>--global<\/code>:<\/p>\n\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><code class=\"\">npx skills add https:\/\/github.com\/WordPress\/agent-skills \\\n  --agent claude-code \\\n  --skill wp-plugin-development \\\n  --skill wp-rest-api \\\n  --global\n<\/code><\/pre><\/div>\n\n\n\n<h3 class=\"wp-block-heading\">Instalar para otro agente<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Cambia el flag <code>--agent<\/code>. Puedes incluso instalar para varios a la vez:<\/p>\n\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><code class=\"\">npx skills add https:\/\/github.com\/WordPress\/agent-skills \\\n  --agent claude-code \\\n  --agent cursor \\\n  --skill wp-block-development \\\n  --skill wp-plugin-development\n<\/code><\/pre><\/div>\n\n\n\n<h3 class=\"wp-block-heading\">Instalar todas las skills<\/h3>\n\n\n\n<p class=\"wp-block-paragraph\">Si quieres instalar todo el paquete completo:<\/p>\n\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><code class=\"\">npx skills add https:\/\/github.com\/WordPress\/agent-skills --all --global\n<\/code><\/pre><\/div>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\">Elegir entre instalaci\u00f3n global o por proyecto<\/h2>\n\n\n\n<ul class=\"wp-block-list\">\n<li class=\"\"><strong>Global<\/strong> (<code>--global<\/code>): Las skills se guardan en el directorio de configuraci\u00f3n de tu agente (por ejemplo, <code>~\/.claude\/skills\/<\/code>). Est\u00e1n disponibles en todos tus proyectos.<\/li>\n\n\n\n<li class=\"\"><strong>Por proyecto<\/strong>: Las skills se copian dentro del directorio del proyecto. \u00datil cuando trabajas en equipo y quieres que todos tengan las mismas instrucciones.<\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Mi recomendaci\u00f3n: si trabajas en varios proyectos WordPress, instala globalmente. Si tienes un proyecto espec\u00edfico con necesidades concretas, instala por proyecto.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\">Gesti\u00f3n de skills: actualizar y eliminar<\/h2>\n\n\n\n<h3 class=\"wp-block-heading\">Buscar Skills<\/h3>\n\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><code class=\"\">npx skills find ###\n<\/code><\/pre><\/div>\n\n\n\n<h3 class=\"wp-block-heading\">Comprobar actualizaciones<\/h3>\n\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><code class=\"\">npx skills check\n<\/code><\/pre><\/div>\n\n\n\n<h3 class=\"wp-block-heading\">Actualizar<\/h3>\n\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><code class=\"\">npx skills update\n<\/code><\/pre><\/div>\n\n\n\n<h3 class=\"wp-block-heading\">Eliminar una skill<\/h3>\n\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><code class=\"\">npx skills remove wp-block-themes\n<\/code><\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Importante: usa el mismo alcance (global o proyecto) que usaste al instalar. Si instalaste con <code>--global<\/code>, las operaciones de actualizaci\u00f3n y eliminaci\u00f3n tambi\u00e9n deben ser globales.<\/p>\n\n\n\n<h3 class=\"wp-block-heading\">Ver skills instaladas<\/h3>\n\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><code class=\"\">npx skills list\n<\/code><\/pre><\/div>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\">Qu\u00e9 skills instalar seg\u00fan tu proyecto<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">No necesitas instalar todas. Elige seg\u00fan lo que est\u00e9s desarrollando:<\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li class=\"\"><strong>Desarrollo de bloques \/ Gutenberg<\/strong>: <code>wp-block-development<\/code> y <code>wp-interactivity-api<\/code><\/li>\n\n\n\n<li class=\"\"><strong>Temas de bloques<\/strong>: <code>wp-block-themes<\/code> y <code>wpds<\/code><\/li>\n\n\n\n<li class=\"\"><strong>Desarrollo de plugins<\/strong>: <code>wp-plugin-development<\/code> y <code>wp-abilities-api<\/code><\/li>\n\n\n\n<li class=\"\"><strong>Operaciones y WP-CLI<\/strong>: <code>wp-wpcli-and-ops<\/code><\/li>\n\n\n\n<li class=\"\"><strong>Rendimiento y calidad<\/strong>: <code>wp-performance<\/code> y <code>wp-phpstan<\/code><\/li>\n<\/ul>\n\n\n\n<p class=\"wp-block-paragraph\">Si vas a hacer un refactor grande que toque bloques, temas y plugins, instala todas.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\">C\u00f3mo funcionan internamente<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Cada skill tiene esta estructura:<\/p>\n\n\n\n<div class=\"cbc-code-wrapper\"><div class=\"cbc-code-bar\"><button class=\"cbc-copy-button\">Copy<\/button><\/div><pre class=\"wp-block-code\"><code class=\"\">skills\/wp-block-development\/\n\u251c\u2500\u2500 SKILL.md              # Instrucciones principales\n\u251c\u2500\u2500 references\/           # Documentaci\u00f3n detallada\n\u2502   \u251c\u2500\u2500 block-json.md\n\u2502   \u251c\u2500\u2500 deprecations.md\n\u2502   \u2514\u2500\u2500 ...\n\u2514\u2500\u2500 scripts\/              # Helpers de detecci\u00f3n y validaci\u00f3n\n    \u2514\u2500\u2500 list_blocks.mjs\n<\/code><\/pre><\/div>\n\n\n\n<p class=\"wp-block-paragraph\">Cuando le pides a tu agente que trabaje con c\u00f3digo WordPress, lee estas skills y sigue los procedimientos documentados en lugar de inventar. Es como darle un manual de buenas pr\u00e1cticas que consulta autom\u00e1ticamente.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<h2 class=\"wp-block-heading\">Conclusi\u00f3n<\/h2>\n\n\n\n<p class=\"wp-block-paragraph\">Las WordPress Agent Skills son una forma sencilla de mejorar la calidad del c\u00f3digo que generan los asistentes de IA. Con un solo comando <code>npx<\/code> las tienes funcionando en tu Mac, sin complicaciones.<\/p>\n\n\n\n<p class=\"wp-block-paragraph\">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\u00e1cticas se nota en cada l\u00ednea de c\u00f3digo.<\/p>\n\n\n\n<hr class=\"wp-block-separator has-alpha-channel-opacity\" \/>\n\n\n\n<p class=\"wp-block-paragraph\"><strong>Referencias:<\/strong><\/p>\n\n\n\n<ul class=\"wp-block-list\">\n<li class=\"\"><a href=\"https:\/\/github.com\/WordPress\/agent-skills\" target=\"_blank\" rel=\"noopener\">Repositorio oficial WordPress\/agent-skills<\/a><\/li>\n\n\n\n<li class=\"\"><a href=\"https:\/\/developer.wordpress.com\/docs\/agent-skills\/\" target=\"_blank\" rel=\"noopener\">Documentaci\u00f3n Agent Skills - WordPress.com<\/a><\/li>\n\n\n\n<li class=\"\"><a href=\"https:\/\/skills.sh\/\" target=\"_blank\" rel=\"noopener\">Skills CLI (skills.sh)<\/a><\/li>\n<\/ul>\n","protected":false},"excerpt":{"rendered":"<p>Los asistentes de IA como Claude Code, Cursor o Copilot son potentes, pero cuando trabajan con WordPress tienden a generar c\u00f3digo anticuado, saltarse patrones de seguridad o ignorar las buenas pr\u00e1cticas de bloques y temas. WordPress Agent Skills son paquetes de instrucciones que ense\u00f1an a estos asistentes a trabajar correctamente con WordPress. En lugar de [&hellip;]<\/p>\n","protected":false},"author":1,"featured_media":4520,"comment_status":"open","ping_status":"open","sticky":false,"template":"","format":"standard","meta":{"iawp_total_views":4,"footnotes":""},"categories":[168],"tags":[],"class_list":["post-4516","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-desarrollo-web"],"_links":{"self":[{"href":"https:\/\/davidperezgar.com\/es\/wp-json\/wp\/v2\/posts\/4516","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/davidperezgar.com\/es\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/davidperezgar.com\/es\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/davidperezgar.com\/es\/wp-json\/wp\/v2\/users\/1"}],"replies":[{"embeddable":true,"href":"https:\/\/davidperezgar.com\/es\/wp-json\/wp\/v2\/comments?post=4516"}],"version-history":[{"count":1,"href":"https:\/\/davidperezgar.com\/es\/wp-json\/wp\/v2\/posts\/4516\/revisions"}],"predecessor-version":[{"id":5971,"href":"https:\/\/davidperezgar.com\/es\/wp-json\/wp\/v2\/posts\/4516\/revisions\/5971"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/davidperezgar.com\/es\/wp-json\/wp\/v2\/media\/4520"}],"wp:attachment":[{"href":"https:\/\/davidperezgar.com\/es\/wp-json\/wp\/v2\/media?parent=4516"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/davidperezgar.com\/es\/wp-json\/wp\/v2\/categories?post=4516"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/davidperezgar.com\/es\/wp-json\/wp\/v2\/tags?post=4516"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}