> ## Documentation Index
> Fetch the complete documentation index at: https://flowglad.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Skills

> Crea paquetes reutilizables para agentes externos y Automations

Las Skills son paquetes reutilizables de instrucciones y archivos de apoyo opcionales. Permiten que tu equipo defina una vez una forma repetible de completar una tarea y la aplique después de manera coherente en Flowglad.

Cada Skill tiene un nombre, un slug de comando con barra, una descripción e instrucciones escritas en Markdown. Los archivos de apoyo pueden proporcionar contexto o recursos adicionales necesarios para seguir esas instrucciones.

## Usa Flowglad como biblioteca de Skills de tu equipo

Flowglad guarda cada Skill como un paquete versionado. Publicar un cambio crea una nueva revisión en lugar de sustituir el paquete anterior. Los administradores de la organización pueden abrir el **History** de una Skill para inspeccionar sus revisiones, comparar cambios, restaurar una revisión anterior o descartar un borrador cuando esas acciones estén disponibles.

Esto proporciona a tu equipo un único lugar gobernado para mantener instrucciones reutilizables, conservando qué versión estaba activa en cada momento. Las revisiones en borrador y rechazadas no sustituyen a la versión activa.

### Gestionar Skills mediante MCP

Después de conectar el servidor MCP de Flowglad, un agente puede inspeccionar y gestionar la biblioteca de Skills de tu organización por ti:

* `skills.list` devuelve las Skills visibles para la conexión.
* `skills.get` devuelve los metadatos de la revisión más reciente y de la activa de una Skill.
* `skills.create` envía un nuevo paquete de Skill.
* `skills.create_candidate` envía una nueva revisión de una Skill existente.
* `skills.publish_revision` verifica y publica una revisión diferida.
* `skills.create_package_upload_session` y `skills.finalize_package_upload_session` transportan paquetes demasiado grandes para enviarlos en línea.
* `skills.get` informa del resultado de verificación y promoción de la solicitud aceptada.

Crear o actualizar Skills requiere el permiso `skills:write` tanto en la membresía de la organización del compañero de equipo como en la concesión de la conexión MCP. Si añades el permiso después de conectar el servidor, vuelve a conectar Flowglad MCP y autoriza `skills:write` para que las herramientas de escritura estén disponibles.

**Permisos:** Los administradores tienen acceso de autoría de Skills de forma predeterminada. Para dar el mismo acceso a un Contributor, abre **Settings** → **Team**, selecciona al compañero de equipo y activa **Skill Authoring**. Esto concede permiso para crear y actualizar las Skills de la organización sin convertir al compañero en administrador.

## Cargar Skills de Flowglad MCP en tu agente

El servidor MCP de Flowglad anuncia `io.modelcontextprotocol/skills` durante la inicialización de MCP. Esto indica a los clientes compatibles que el servidor implementa los métodos de Skills para agentes `skills/list` y `skills/get`. Cada Skill devuelta incluye URIs de recursos `skill://` y digests del contenido; los clientes pueden recuperar los archivos con `resources/read`.

Conectar el servidor no garantiza que un cliente vaya a llamar a `skills/list` ni a instalar los paquetes devueltos. La compatibilidad varía según el cliente. Añade una instrucción de inicio a ChatGPT / Codex o Claude cuando quieras que el agente actualice el registro de Flowglad al comienzo de cada sesión.

**Nomenclatura de MCP:** Los nombres son intencionadamente distintos. `skills.list` con punto es una herramienta de Flowglad para los registros de Skills versionados de tu organización. `skills/list` con barra es un método de extensión del protocolo MCP para descubrir paquetes de Skills orientados a agentes.

### Añadir la instrucción de inicio

Crea el directorio de destino una vez antes de iniciar una nueva sesión y, después, añade el bloque de instrucciones correspondiente que aparece a continuación.

#### ChatGPT / Codex

Crea el directorio de destino de ChatGPT / Codex con `mkdir -p ~/.agents/skills`.

Coloca el siguiente bloque en `~/.codex/AGENTS.md` para aplicarlo a todos los proyectos, o en el `AGENTS.md` de un repositorio para compartirlo con el equipo de ese repositorio.

```markdown AGENTS.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.agents/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `$skill-name` invocation.
6. If this ChatGPT / Codex client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

#### Claude

Crea el directorio de destino de Claude con `mkdir -p ~/.claude/skills`.

Coloca el siguiente bloque en `~/.claude/CLAUDE.md` para aplicarlo a todos los proyectos, o en el `CLAUDE.md` de un repositorio para compartirlo con el equipo de ese repositorio.

```markdown CLAUDE.md theme={null}
## Flowglad MCP Skill bootstrap

At the start of every new session, before handling the first task:

1. Confirm that the Flowglad MCP server is connected.
2. Refresh the agent Skill catalog from Flowglad. Prefer the advertised `skills/list` MCP extension method. If the client does not expose that method directly, use the Flowglad server's `resources/list` method and select resources whose URIs begin with `skill://flowglad/`.
3. For every returned Skill, retrieve its manifest with `skills/get` when available, then read each listed resource with `resources/read`, beginning with `SKILL.md`.
4. Synchronize the package into `~/.claude/skills/<skill-name>/`. Compare the returned content digests and rewrite only new or changed Flowglad-managed files. Never overwrite or delete unrelated local Skills.
5. Treat the refreshed Flowglad package as the source of truth for this session. Make the synchronized Skills available for automatic matching and explicit `/skill-name` invocation.
6. If this Claude client cannot call the Skill or resource methods, report that limitation once and continue without claiming that the registry was refreshed.
```

Puedes pedir a ChatGPT / Codex o a Claude que añada el bloque adecuado a su propio archivo de instrucciones a nivel de usuario. Revisa la edición propuesta antes de aceptarla, porque ese archivo afecta a las sesiones futuras. La instrucción es un bootstrap del agente de mejor esfuerzo; si tu entorno debe actualizar las Skills de forma determinista, implementa la misma sincronización en un hook `SessionStart` de confianza o en la integración de tu cliente MCP.

## Dónde se usan las Skills

Las Skills tienen actualmente dos consumidores:

* Los agentes externos compatibles descubren y sincronizan los paquetes habilitados a través de Flowglad MCP y, después, los emparejan automáticamente o los invocan por su nombre.
* Las Automations fijan una revisión publicada exacta de una Skill como recurso de código OWS `skill-revision`. La Automation selecciona una ruta de paquete y un punto de entrada; los pasos del agente reciben solo las Skills autorizadas por el conjunto de capacidades sellado de la ejecución.

La primera vía proporciona instrucciones reutilizables a un agente externo. La segunda proporciona código inmutable y archivos de apoyo a una ejecución repetible de una Automation. Las Skills publicadas abarcan toda la organización, por lo que una Automation autorizada puede seleccionar la misma revisión de Skill en cualquier Space. La Automation consumidora y sus ejecuciones siguen perteneciendo a su Space; seleccionar una Skill no cambia ese límite.

## Crear y mantener Skills

Abre el **organization menu** → **Skills** → **New Skill**. En la pestaña **Skill**, introduce **Name**, **Slug**, una **Description** opcional y las instrucciones reutilizables en **Markdown**. Usa la pestaña **Files** para los archivos de apoyo del paquete y, después, selecciona **Create Skill**.

El Slug usa letras minúsculas, números y guiones, empieza por una letra o un número, y es lo que los usuarios escriben después de `/`.

Crear o editar una Skill genera un borrador. En la página de detalle de la Skill, las ediciones se guardan automáticamente; selecciona **Publish Draft** para verificar y publicar el borrador. Si la verificación falla, usa los diagnósticos mostrados para corregir el borrador y vuelve a publicarlo.

Usa **History** para inspeccionar revisiones, restaurar una revisión sustituida o descartar un borrador editable cuando esas acciones estén disponibles. **Disable Skill** la retira del descubrimiento por agentes externos y de la resolución de Automations sin eliminar el historial de revisiones; **Enable Skill** la vuelve a poner a disposición.

## Crear o editar una Skill con MCP

Usa un cliente MCP externo conectado para la autoría centrada en paquetes. Llama a `skills.get` antes de editar una Skill existente. Usa `skills.create` para un paquete nuevo o `skills.create_candidate` para una revisión basada en la revisión activa actual.

Los paquetes pequeños pueden proporcionarse en línea. Para paquetes más grandes, llama a `skills.create_package_upload_session`, sube los objetos solicitados y termina con `skills.finalize_package_upload_session`. Si la verificación se difirió, llama a `skills.publish_revision`. Consulta periódicamente `skills.get` para conocer la solicitud de ciclo de vida aceptada y su resultado de verificación o promoción.

Publicar una Skill no crea, revisa ni activa una Automation; usa explícitamente el ciclo de vida MCP de Automations cuando lo necesites.

## Empezar desde una plantilla de Skill

La página **Skills** incluye **Skill Templates**. Busca o filtra el catálogo, previsualiza una plantilla y selecciona **Copy Skill**. La copia se convierte en una Skill de la organización que se puede editar y publicar como cualquier otra Skill.

## Skills y Automations

Una Skill define cómo realizar un trabajo reutilizable. No decide cuándo se ejecuta ese trabajo.

Usa una Automation cuando el trabajo deba ejecutarse manualmente, según una programación o en respuesta a un evento. Una Automation puede fijar una o varias revisiones de Skills para que la misma implementación se reutilice en todas las ejecuciones.


## Related topics

- [MCP](/docs/es/mcp-server.md)
- [Automations](/docs/es/automations.md)
- [Te damos la bienvenida](/docs/es/agents/introduction.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.