Skills

Showly Habilidades

Habilidades como interfaz visible para el usuario para las capacidades del agente.

Showly publica una Claude Code Skill oficial que envuelve el servidor MCP con indicaciones orientadas a tareas. La habilidad es la forma más fácil de usar Showly desde un agente: la instalas, el agente sabe automáticamente cuándo invocar las herramientas Showly y las indicaciones ya codifican las convenciones del bucle de publicación.

Por qué las habilidades

Un servidor MCP sin formato proporciona herramientas al agente. Una Habilidad le enseña al agente _cuándo_ y _por qué_ usarlas. La habilidad Showly incluye:

  • Una descripción que se activa según la intención ("implementar", "publicar", "vista previa", "llamativa").
  • Scripts internos que encadenan create_change_plan → apply_site_patch → create_preview → run_checks → request_publish para que el agente no tenga que hacerlo.
  • Pasos de verificación que leen la URL de vista previa e informan.
  • Patrones de rechazo de acciones que el agente no debería realizar por sí solo (las publicaciones de producción siempre van a un humano a través de la puerta de aprobación).

Instalando la Skill oficial

En Claude Code (o Codex):

npx @showly/mcp-server install --to claude-code   # or --to codex

Esto se instala desde el paquete @showly/mcp-server y registra el servidor Showly MCP por usted. No hay ningún token que configurar: la primera vez que invoca una herramienta Showly, su agente abre una pestaña del navegador para iniciar sesión y aprobar el acceso, y Showly emite un token de alcance directamente al agente (estándar MCP OAuth). Consulte Instalación de la habilidad para conocer el protocolo de enlace completo y la opción sin navegador.

¿Qué hace la habilidad que raw MCP no hace?

  • Descubre automáticamente el sitio activo desde el directorio de trabajo actual haciendo coincidir el control remoto GitHub del repositorio con los sitios en su espacio de trabajo Showly.
  • Presenta vistas previas en línea con capturas de pantalla de mcp__playwright_browser_take_screenshot si Playwright MCP también está instalado.
  • Se niega a solicitar una publicación sin una vista previa reciente; Las publicaciones de producción siempre pasan por request_publish y una aprobación humana.

Descubrimiento automático

Cuando ejecuta un agente dentro de un repositorio registrado, Skill lee el origin remoto del repositorio y busca un sitio en su espacio de trabajo cuyo repositoryUrl coincida. El siteId del sitio coincidente se convierte en el objetivo de get_site_context, apply_site_patch, create_preview y el resto del bucle, por lo que rara vez tendrás que nombrar un sitio a mano.

Si ningún sitio coincide con el control remoto, Skill le pedirá que elija o cree uno en lugar de adivinar. Si varios sitios comparten el control remoto, le pedirá que elimine la ambigüedad.

Publicar barandillas

La producción nunca se publica directamente desde un agente. Antes de solicitar una publicación, la Skill comprueba que:

  • Hay una implementación de vista previa ready reciente para el sitio.
  • run_checks ha pasado contra esa previa.

Cuando se mantienen, la habilidad llama a request_publish, lo que devuelve un enlace profundo webApprovalUrl. Un humano con derechos de administrador aprueba la solicitud en la interfaz de usuario web; el agente solo sondea el estado de aprobación. No existe camino de agente que promueva a producción sin ese paso humano.

Próximo