Skills

Creación de habilidades personalizadas

Prepare sus propios flujos de trabajo para que cualquier agente conectado a Showly pueda usarlos.

La habilidad oficial Showly cubre el ciclo de publicación canónica. Los equipos suelen tener flujos de trabajo _adicionales_ específicos de su pila: control de calidad de la marca, comprobaciones de cumplimiento del contenido, localización automatizada. Puedes enviarlas como habilidades personalizadas que cualquier agente conectado a Showly podrá adquirir.

Cuándo escribir una habilidad versus solo un guión

Escribe una habilidad cuando:

El flujo de trabajo se _activa por intención_ (el usuario dice "implementar" o "traducir" y el agente debería saberlo).
El flujo de trabajo tiene patrones de rechazo/seguridad que vale la pena codificar (no enviar sin controles, no publicar durante la congelación).
Es reutilizable entre miembros del equipo o proyectos.

Simplemente escriba un guión cuando:

El flujo de trabajo se ejecuta en CI, no en una conversación con un agente.
Es algo único que tirarás a la basura.

Anatomía de una habilidad consciente de Showly

Una habilidad es un manifiesto más indicaciones. El mínimo:

name: my-publish-with-localize
description: |
  Use when the user wants to publish a Showly site that has
  user-facing strings. This skill localizes new/changed strings,
  runs `run_checks`, then proposes a publish.
trigger:
  intents:
    - "publish"
    - "ship"
    - "release"
mcp:
  required:
    - showly
    - localizer
prompt: |
  1. Call mcp__showly__get_site_context to read the change.
  2. Identify new/changed strings in any *.tsx files.
  3. Call mcp__localizer__translate for each new string.
  4. Apply translations via mcp__showly__apply_site_patch.
  5. Call mcp__showly__create_preview.
  6. Call mcp__showly__run_checks (include `i18n-coverage`).
  7. If checks pass, call mcp__showly__request_publish.
  8. Refuse to call request_publish if any check failed.

Referencia de campo

Campo	Tipo	Requerido	Notas
`name`	cadena	si	El identificador de habilidad. Estable en todas las versiones; cambiarle el nombre es un cambio radical.
`description`	cadena	si	Cuándo el agente debe alcanzar esta Habilidad. Escrito para el agente, no para el usuario final: describa la situación desencadenante.
`trigger.intents`	matriz de cadenas	no	Frases que resaltan la habilidad (por ejemplo, `"publish"`, `"ship"`). Si se omite, el agente depende únicamente de `description` para decidir cuándo invocarlo.
`mcp.required`	matriz de cadenas	no	MCP servidores que deben estar conectados para que se ejecute la habilidad (por ejemplo, `showly` más cualquiera de los suyos).
`prompt`	cadena	si	Las instrucciones que sigue el agente, escritas como pasos numerados.

Los pasos prompt no los ejecuta Showly; son instrucciones entregadas al agente. El agente los lee en orden y llama a las herramientas MCP nombradas (por ejemplo, mcp__showly__get_site_context, luego mcp__showly__apply_site_patch), aplicando cualquier verificación de rechazo que codifique. Utilice los identificadores de herramientas exactos de la MCP referencia de herramienta para que el agente llame a herramientas reales. La ruta de producción hacia un sitio activo siempre es request_publish, lo que devuelve un webApprovalUrl para que un humano complete la publicación; la Skill no puede publicar en producción por sí sola.

Para obtener el esquema de manifiesto completo (el manifest.json escrito en la habilidad oficial se envía), consulte Instalar la habilidad.

Patrones de rechazo

La parte más difícil de una habilidad útil es codificar _lo que no se debe hacer_. Ejemplos de la habilidad oficial Showly:

No publicar sin una vista previa reciente: si create_preview no ha sido llamado en esta conversación, rechaza request_publish.
No publicar durante la congelación: si la política del espacio de trabajo dice "congelación de fusión activa", rechace y vincule el anuncio de congelación.
No hay publicación de rotura de cristales: MCP no tiene bypass de emergencia. Si el usuario dice que la solución es urgente, aún así cree una vista previa, ejecute comprobaciones y solicite aprobación.

Codifique estos en su mensaje como viñetas que el agente debe verificar antes de cada llamada a la herramienta.

Distribución

Tres opciones:

Personal: coloca la habilidad en ~/.claude/skills/. Sólo tú lo ves.
Espacio de trabajo: confírmalo en el repositorio de tu sitio Showly en .showly/skills/. Cualquier persona con acceso al espacio de trabajo lo instala automáticamente.
Público: publica tu Skill como su propio paquete y deja que otros lo instalen de la misma manera que se instala el cliente Showly oficial: npx @showly/mcp-server install --to <claude-code|codex|stdout>. Este es el comando de instalación canónico: sigue la misma forma para que los autores y los instaladores sigan el mismo camino.

Las rutas de instalación anteriores coinciden con Instalar la habilidad: el comando canónico es npx @showly/mcp-server install (el paquete @showly/mcp-server, bin showly-mcp). Utilice la misma forma para su habilidad personalizada para que los autores y los instaladores sigan un camino.

Versionado

Las habilidades siguen semver. Los cambios importantes (cambiar el nombre de las intenciones, eliminar pasos de la herramienta) generan una nueva especialidad. Ejecute showly-mcp (el contenedor enviado por @showly/mcp-server) para instalar y actualizar; Al volver a ejecutar npx @showly/mcp-server install se obtiene la última versión.

Dónde leer a continuación

MCP referencia de herramienta: qué hace cada herramienta y cómo encadenarlas.
Modelo de habilidades: por qué existen las habilidades y en qué se diferencian de las herramientas en bruto.