Skills y Rules
Al conectar MCP a un agente LLM, el agente puede llamar directamente a la API de WEEGLOO. Sin embargo, poder llamar a una API no es lo mismo que usarla con exactitud, del modo que WEEGLOO pretende. Por ejemplo, en qué situación usar CMA y en cuál usar CDA, cómo diseñar los campos de un Content Type, o qué permisos vincular a un Delivery Access Token para que sea seguro: nada de eso se sabe solo con el método de llamada.
Skills y Rules son las dos guías que cubren esta brecha. Skills es una guía que recoge el modo de realizar bien una tarea concreta, y Rules son las reglas que hay que respetar a lo largo de todo el trabajo. La herramienta de instalación (npx weegloo@latest) puede instalar ambas junto con la conexión MCP.
Diferencia entre Skills y Rules
Las dos coinciden en que son información que se da al agente, pero su función es distinta.
Skills es una guía que recoge, en forma de pasos y patrones, cómo realizar una tarea concreta. Hay una por cada tarea, y el agente lee y sigue la Skill correspondiente cuando empieza esa tarea. Por ejemplo, hay una Skill para cada tarea como el diseño de un Content Type, la elección de la arquitectura de servicio o la emisión de un Delivery Access Token. Así el agente sigue un método verificado en lugar de hacer suposiciones.
Rules son las reglas que hay que respetar siempre, con independencia del tipo de tarea. Por ejemplo, la dirección base de la API de WEEGLOO, la forma de obtener una lista de recursos por páginas, o el hecho de que al modificar un recurso hay que enviar también la información de versión. El agente aplica estas reglas como trasfondo durante todo el trabajo.
En resumen, Skills es una guía por tarea que dice «esta tarea se hace así», y Rules son las reglas comunes que dicen «esto se respeta sea cual sea la tarea».
Instalación
Skills y Rules los instala conjuntamente la herramienta de instalación de MCP. Basta con ejecutar lo siguiente en la terminal.
npx weegloo@latestAl ejecutarlo, pregunta de forma sucesiva por el entorno (agente) que se va a conectar y por el Personal Access Token, e instala las Skills y Rules en ese entorno junto con la conexión MCP. El proceso de instalación y la configuración por entorno se tratan en Conectar.
Si usa @latest, siempre se instala la versión más reciente. El modo de ponerlo al día cuando ya lo tiene instalado se trata en Mantenerlo al día.
Mantenerlo al día
Las Skills y las Rules no se instalan una sola vez y ya está. Cada vez que WEEGLOO estrena funciones y cambian los modos recomendados, estas indicaciones se actualizan con ellas. En cambio, lo que está instalado en su ordenador es una copia del momento de la instalación, así que se queda como estaba.
Cuando la instalación se queda antigua, ocurren dos cosas. Las Skills y Rules recién añadidas no existen en esa instalación, de modo que el agente no sabe cómo tratar esas funciones. Y si ha cambiado el contenido de un elemento que ya existía, el agente sigue las indicaciones anteriores tal cual. En cualquiera de los dos casos, el agente trabaja tomando como referencia el WEEGLOO del momento de la instalación y no el de ahora. La calidad de los resultados que entrega el agente se decide aquí, así que conviene mantener las Skills y las Rules al día.
Lo que hay que mantener al día son las Skills y las Rules instaladas en su ordenador. El servidor MCP no tiene nada que actualizar aparte.
Cuando sale una versión nueva, el agente avisa. El agente comprueba la versión instalada al empezar un trabajo relacionado con WEEGLOO y, si ya es la más reciente, no muestra nada. Solo cuando hay algo que actualizar muestra un aviso como el siguiente junto con el comando que hay que ejecutar.
Esta actualización no se ejecuta de forma automática. Como es un trabajo que reescribe los archivos instalados, se ejecuta después de que usted lo confirme. Cuando aparezca el aviso, conviene no dejarlo para después y ejecutar el comando en ese mismo momento. Basta con ejecutar en la terminal, tal cual, el comando que aparece en el aviso.
En el lugar de --agent y --location van el entorno y la ubicación que eligió al instalar, así que el comando varía según el estado de la instalación. Si usa tal cual el comando que aparece en el aviso, los valores correctos ya vienen puestos.
En lugar de escribir el comando usted mismo, también puede decirle al agente «actualiza weegloo». El agente ya conoce el comando que debe ejecutar, así que no hace falta buscar cuál se usa.
Qué conserva y qué cambia una actualización
Una actualización no es volver a instalar desde cero. Mantiene las opciones que eligió en la primera instalación y solo pone el contenido al día.
- La selección de Skills y Rules que hizo al instalar se mantiene tal cual. Si instaló solo una parte, queda en ese estado.
- Las Skills y Rules añadidas después de la última instalación se instalan automáticamente. Los elementos que excluyó a propósito al instalar siguen excluidos.
- Los elementos eliminados del repositorio también se quitan de su ordenador.
- Se queda en la versión que eligió al instalar.
- No toca la configuración del servidor MCP. Por eso, al actualizar no hace falta el Personal Access Token.
Si borró a mano un archivo de Skill o de Rule instalado, la actualización vuelve a instalar ese archivo. Para quitar un elemento, no borre el archivo: vuelva a ejecutar el comando de instalación y desmárquelo en la pantalla de selección.
El contenido actualizado se aplica a partir de una conversación nueva. El agente lee las Skills y las Rules al empezar la conversación, así que una conversación en curso sigue usando el contenido anterior.
Consultar directamente
Skills y Rules están en un repositorio público. Para abrir directamente el contenido instalado, o para comprobar qué guía corresponde a cada tarea, puede consultar el repositorio.
- Repositorio: github.com/weeglooapi/weegloo-mcp-plugin
Skills y Rules se encuentran bajo plugins/weegloo/ del repositorio, en los directorios skills/ y rules/ respectivamente.
- Directorio de Skills: plugins/weegloo/skills
- Directorio de Rules: plugins/weegloo/rules
También cuando se integra directamente sin usar la herramienta de instalación, basta con tomar tal cual los archivos de la ruta latest anterior.