Instala la skill de POM Site Authoring

Usa esta guía si quieres que Claude Code o Codex cree o perfeccione un sitio web de POM. La skill proporciona orientación de diseño e instrucciones para usar las herramientas que expone tu sitio. POM AI ofrece la conexión autenticada y realiza las operaciones de WordPress.

Para una visión práctica con ejemplos de solicitudes, lee Qué puede hacer POM Site Authoring y cómo preguntar.

Antes de empezar

• Activa POM Theme y una versión de POM AI que incluya las herramientas de autoría del sitio.
• Habilita POM AI MCP en Settings → POM AI → AI Tools. Conecta tu agente siguiendo la guía de conexión del cliente.
• Usa una cuenta con las capacidades de WordPress necesarias para el trabajo y habilita los controles de escritura pertinentes.
• Ten instalado Claude Code o Codex. El ordenador que ejecuta el agente no necesita WordPress, PHP ni una copia del theme. El agente debe poder acceder al MCP del sitio; la verificación visual también requiere acceso a un navegador.

La skill no concede acceso, no instala productos de WordPress ni configura una licencia. La licencia del producto y la autorización de MCP son cuestiones independientes.

Instálala con un solo prompt

La skill ya está incluida en POM AI. No necesitas descargar un segundo paquete.

1. Conecta Claude Code o Codex al MCP de tu sitio, o al MCP de tu cuenta elegible.

2. Envía este prompt en el proyecto previsto:

   Install the POM Site Authoring skill included in this MCP for this project. Use pom_get_authoring_skill to retrieve its instructions and complete files.

3. El agente recupera el manifiesto y los archivos de la skill, comprueba su integridad e instala la carpeta completa en el directorio de skills del proyecto. Utiliza su propio acceso a archivos; sigue los permisos que requiera tu agente. Las ediciones locales existentes deben conservarse antes de una actualización.

4. Confirma la versión y la ubicación indicadas. En Codex, selecciona la skill a través de /skills o menciona $pom-site-authoring. En Claude Code, usa /pom-site-authoring. Reinicia o vuelve a abrir la sesión si el cliente no ha detectado la carpeta.

5. Pide al agente que identifique la URL del sitio previsto e inspeccione sus capacidades de autoría antes de tu primer cambio en el sitio web.

Para una instalación personal en varios proyectos, cambia el prompt para que diga «for all my projects». Estas ubicaciones siguen la guía de skills de Codex y la guía de skills de Claude Code:

Resultado esperado: el agente informa de la versión instalada y reconoce la skill. Conectar MCP no instala archivos automáticamente, e instalar la skill no crea una conexión ni concede permisos en el sitio web.

Úsala sin instalar archivos

Los clientes que no disponen de almacenamiento persistente de skills pueden usar las mismas instrucciones a través de MCP. Pregunta:

Read the POM Site Authoring skill included in this MCP and use it for this website during our conversation.

El agente lee el punto de entrada y las referencias pertinentes según sea necesario. No hay descarga manual ni requisito de WordPress local. La orientación se aplica a esa conversación; no es una skill instalada para sesiones posteriores. Las herramientas disponibles del sitio web y el acceso al navegador siguen dependiendo del cliente y de la conexión.

Descarga manual opcional

Si prefieres gestionar los archivos tú mismo, abre Settings → POM AI → MCP server y elige Download POM site skill. Extrae el ZIP y copia la carpeta pom-site-authoring completa en una de las ubicaciones anteriores. SKILL.md debe quedar directamente dentro de ella, junto a INSTALL.md, references, assets y agents. Evita instalaciones duplicadas entre distintos ámbitos.

Referencia de entrega mediante MCP

pom_get_authoring_skill es una herramienta de solo lectura disponible en ambos modos de MCP y en la conexión de cuenta. Requiere una conexión autenticada con mcp:read cuando se usa OAuth. Lee únicamente la skill incluida en ese servidor; no instala nada en el agente ni en el sitio web.

Para una instalación persistente, el agente recupera y verifica cada archivo antes de colocar la carpeta completa en el directorio seleccionado. Para el uso en sesión, lee SKILL.md y solo las referencias enlazadas pertinentes. Una respuesta de archivo truncada debe solicitarse de nuevo. El MCP de cuenta sirve directamente su skill integrada; seleccionar un destino es necesario para las operaciones del sitio web, no para obtener la skill.

Da al agente un encargo útil

Proporciona el dominio, el propósito comercial, la audiencia prevista, el material de marca existente y las páginas o funciones que necesitas. Indica si el trabajo debe permanecer en borrador o publicarse. Por ejemplo:

Use POM Site Authoring on my connected studio website. Preserve its existing identity and prepare a draft Projects page with a filterable project catalogue, project categories, area fields and individual project templates. Inspect what already exists before creating anything. Verify the affected layouts in the browser.

Para un sitio web nuevo, incluye la navegación, el pie de página, los métodos de contacto y las preferencias de cookies que quieras configurar. Aporta los datos reales del propietario para los borradores legales. El agente debe identificar los datos que faltan en lugar de presentar marcadores de posición como contenido legal finalizado.

Los archivos JSON incluidos son recetas editables, no importaciones de ajustes. El agente los adapta a los esquemas activos del sitio y los aplica mediante planes de sitio reanudables. Un plan guardado registra el progreso; no es una copia de seguridad del sitio ni una función de deshacer automática.

Pide una mejora de diseño concreta

La skill admite solicitudes de diseño en lenguaje corriente. No necesitas instalar comandos separados para tipografía, diseños móviles ni revisiones visuales. Por ejemplo:

Review the design of the connected Services page without editing it. Assess the reading order, typography, imagery and contact action on desktop and mobile. Show the most useful improvements with evidence from the page.

Polish this Projects page while preserving its identity, URLs and content. Improve the filter layout, result hierarchy and mobile spacing. Keep the native search, selections, counts, reset and pagination working.

Design a new Services page using the supplied brand assets. Explain the visual direction briefly, implement it with editable POM modules, and inspect the complete page and contact path at desktop and mobile sizes. Keep it in draft.

Para un diseño nuevo, el agente conecta la tarea del visitante con la composición, los estilos de texto, los roles de color, las imágenes y el comportamiento adaptable. Los estilos compartidos usan los ajustes del sitio cuando corresponde; los refinamientos específicos de página usan controles de módulo o estilos con alcance limitado. Una solicitud de revisión de una página no autoriza cambios. Las fotografías, los datos comerciales o el acceso al navegador que falten deben aparecer como limitaciones concretas en el resultado.

La skill construye con el POM Page Builder instalado y con las plantillas nativas de archive, feed y artículo individual. Elige entre las estructuras de cabecera del theme y normalmente compone un pie de página nuevo como una fila habilitada que contiene un bloque reutilizable, cuyo diseño interno sigue siendo editable en el builder. Los pies de página existentes se conservan salvo que se solicite un reemplazo.

Para el estilo, usa controles nativos y ediciones de CSS concisas. Settings → POM Theme → Advanced → Custom CSS expone editores de componentes y de activos separados, además de CSS global y hojas de estilo con nombre. Las hojas de estilo con nombre pueden enlazarse a las plantillas pertinentes. Los editores de componentes reemplazan su fragmento de código fuente completo; la skill conserva las reglas existentes y revisa los cambios de código fuente en lugar de acumular anulaciones. Cuando el MCP conectado carece de un editor de componentes o de una operación de widget, el agente necesita administración autorizada en el navegador para ese paso.

La skill puede asignar scripts que ya están presentes en el catálogo del theme a páginas, entradas y plantillas. No crea ni modifica JavaScript, no añade nuevas librerías de scripts ni crea código de filtrado personalizado. El HTML sigue la política KSES de la instalación y la administración de usuarios queda excluida. Los menús, las cabeceras fijas, los formularios, las galerías y las facetas usan las interacciones existentes del theme. Las solicitudes de diseño que requieren scripts nuevos se comunican como ajenas a este flujo de trabajo.

Verifica y mantén

Comprueba que el código fuente de la página resultante sigue siendo editable, que los enlaces y las plantillas se resuelven correctamente y que las rutas de visitante de escritorio y móvil pertinentes funcionan. Para los listados, incluye filtros, restablecimiento y resultados vacíos; para los formularios, incluye la retroalimentación de campos obligatorios. Revisa la página completa además de su apertura: la cabecera, el pie de página, las páginas de detalle y los estados de interacción deben usar reglas visuales coherentes. El agente debe informar de las páginas reales, los tamaños de captura, las comprobaciones observadas, el comportamiento no verificado y qué trabajo permanece en borrador. La emulación del área de visualización en el navegador es distinta de comprobar un teléfono real.

Para actualizar, pide al agente que actualice la skill de POM Site Authoring desde el MCP conectado. Comprueba la versión servida y los hashes de los archivos, conserva cualquier modificación local y reemplaza la carpeta completa. Actualiza la sesión si el cliente no ha detectado la actualización. Para eliminarla, borra solo esa carpeta instalada. Eliminar la skill no revoca su conexión MCP ni elimina el contenido del sitio web; revoca el acceso por separado cuando sea necesario.

Solución de problemas

• Falta la herramienta de la skill: actualiza POM AI en el servidor conectado y refresca el descubrimiento de MCP. Para un MCP de cuenta, su servidor debe incluir el paquete de POM AI actualizado.
• El cliente no puede instalar archivos: usa el prompt de solo conversación anterior. El MCP no puede conceder acceso al sistema de archivos ni soporte persistente de skills a un cliente.
• Transferencia modificada o incompleta: pide al agente que obtenga un manifiesto nuevo y reintente la transferencia completa. No instales una mezcla de versiones.
• No hay botón de descarga: la descarga manual es opcional; comprueba que el paquete de POM AI instalado esté completo si necesitas el ZIP.
• La skill no aparece en la lista: el directorio de skills del agente debe contener pom-site-authoring/SKILL.md, sin una carpeta de extracción anidada adicional. Reinicia la sesión y comprueba si hay instalaciones duplicadas.
• No hay herramientas del sitio: conecta el MCP del sitio de forma independiente. No pegues la licencia del producto en los campos de autenticación de MCP.
• Se rechaza una escritura: inspecciona la capacidad de WordPress, el ámbito de OAuth o el control de escritura indicados. Instalar la skill no cambia esos controles.
• Faltan formularios u opciones de facetas: pide al agente que inspeccione la función opcional de POM pertinente y refresca el descubrimiento tras la activación autorizada.
• Varios dominios: nombra explícitamente el sitio previsto. La skill admite conexiones directas de sitio y el MCP de cuenta único disponible para las cuentas elegibles de POM AI Unlimited. Inscribe cada sitio web en My Account → POM AI Management → AI site connections, autoriza al agente con la Account MCP URL mostrada y pídele que liste los sitios inscritos antes de seleccionar uno. La conexión de cuenta requiere MCP nativo y OAuth en cada destino.

Continúa con creación de sitios filtrables, ajustes tipados o formularios y navegación.