> ## 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

> Les Skills són paquets versionats d'instruccions en Markdown i fitxers de suport que es gestionen via MCP i s'apliquen a agents externs i Automations.

Les Skills són paquets reutilitzables d'instruccions i de fitxers de suport opcionals. Permeten que el vostre equip defineixi una sola vegada una manera repetible de completar una tasca i que després l'apliqui de manera coherent a tot Flowglad.

Cada Skill té un nom, un slug de slash command, una descripció i instruccions escrites en Markdown. Els fitxers de suport poden proporcionar context addicional o recursos necessaris per seguir aquestes instruccions.

## Utilitzeu Flowglad com a biblioteca de Skills del vostre equip

Flowglad desa cada Skill com un paquet versionat. Publicar un canvi crea una revisió nova en lloc de substituir el paquet anterior. Els administradors de l'organització poden obrir l'**History** d'una Skill per inspeccionar-ne les revisions, comparar canvis, restaurar una revisió anterior o descartar un esborrany quan aquestes accions estiguin disponibles.

Això proporciona al vostre equip un únic lloc governat per mantenir instruccions reutilitzables i, alhora, conservar quina versió estava activa en cada moment. Les revisions en esborrany i les rebutjades no substitueixen la versió activa.

### Gestioneu les Skills mitjançant MCP

Després de connectar el servidor MCP de Flowglad, un agent pot inspeccionar i gestionar la biblioteca de Skills de la vostra organització per vosaltres:

* `skills.list` retorna les Skills visibles per a la connexió.
* `skills.get` retorna les metadades de la revisió més recent i de la revisió activa d'una Skill.
* `skills.create` envia un paquet de Skill nou.
* `skills.create_candidate` envia una revisió nova d'una Skill existent.
* `skills.publish_revision` verifica i publica una revisió ajornada.
* `skills.create_package_upload_session` i `skills.finalize_package_upload_session` transporten paquets massa grans per enviar-los inline.
* `skills.get` informa del resultat de verificació i promoció de la sol·licitud acceptada.

Crear o actualitzar Skills requereix el permís `skills:write` tant a la pertinença a l'organització del membre de l'equip com a la concessió de la connexió MCP. Si afegiu el permís després de connectar el servidor, torneu a connectar Flowglad MCP i autoritzeu `skills:write` perquè les eines d'escriptura estiguin disponibles.

**Permisos:** Els administradors tenen accés d'autoria de Skills per defecte. Per donar el mateix accés a un Contributor, obriu **Settings** → **Team**, seleccioneu el membre de l'equip i activeu **Skill Authoring**. Això concedeix permís per crear i actualitzar Skills de l'organització sense convertir el membre de l'equip en administrador.

## Carregueu les Skills de Flowglad MCP al vostre agent

El servidor MCP de Flowglad anuncia `io.modelcontextprotocol/skills` durant la inicialització d'MCP. Això indica als clients compatibles que el servidor implementa els mètodes de Skills d'agent `skills/list` i `skills/get`. Cada Skill retornada inclou URIs de recursos `skill://` i digests de contingut; els clients poden recuperar els fitxers amb `resources/read`.

Connectar el servidor no garanteix que un client cridi `skills/list` ni que instal·li els paquets retornats. La compatibilitat varia segons el client. Afegiu una instrucció d'inici a ChatGPT / Codex o a Claude quan vulgueu que l'agent actualitzi el registre de Flowglad al començament de cada sessió.

**Noms d'MCP:** Els noms són diferents de manera intencionada. `skills.list`, amb un punt, és una eina de Flowglad per als registres de Skills versionats de la vostra organització. `skills/list`, amb una barra, és un mètode d'extensió del protocol MCP per descobrir paquets de Skills orientats a agents.

### Afegiu la instrucció d'inici

Creeu el directori de destinació una vegada abans d'iniciar una sessió nova i, a continuació, afegiu el bloc d'instruccions corresponent que trobareu a continuació.

#### ChatGPT / Codex

Creeu el directori de destinació de ChatGPT / Codex amb `mkdir -p ~/.agents/skills`.

Poseu el bloc següent a `~/.codex/AGENTS.md` per aplicar-lo a tots els projectes, o a l'`AGENTS.md` d'un repositori per compartir-lo amb l'equip d'aquest repositori.

```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

Creeu el directori de destinació de Claude amb `mkdir -p ~/.claude/skills`.

Poseu el bloc següent a `~/.claude/CLAUDE.md` per aplicar-lo a tots els projectes, o al `CLAUDE.md` d'un repositori per compartir-lo amb l'equip d'aquest repositori.

```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.
```

Podeu demanar a ChatGPT / Codex o a Claude que afegeixi el bloc adequat al seu propi fitxer d'instruccions d'usuari. Reviseu la modificació proposada abans d'acceptar-la, perquè aquest fitxer afecta les sessions futures. La instrucció és un bootstrap de l'agent amb el millor esforç possible; si el vostre entorn ha d'actualitzar les Skills de manera determinista, implementeu la mateixa sincronització en un hook `SessionStart` de confiança o a la integració del vostre client MCP.

## On s'utilitzen les Skills

Actualment, les Skills tenen dos consumidors:

* Els agents externs compatibles descobreixen i sincronitzen els paquets habilitats mitjançant Flowglad MCP i després els fan coincidir automàticament o els invoquen pel nom.
* Les Automations fixen una revisió publicada exacta d'una Skill com a recurs de codi OWS `skill-revision`. L'Automation selecciona un camí de paquet i un entrypoint; els passos d'agent només reben les Skills autoritzades pel conjunt de capacitats segellat de l'execució.

El primer camí proporciona instruccions reutilitzables a un agent extern. El segon proporciona codi immutable i fitxers de suport a una execució repetible d'una Automation. Les Skills publicades abasten tota l'organització, de manera que una Automation autoritzada pot seleccionar la mateixa revisió de Skill en qualsevol Space. L'Automation consumidora i les seves execucions continuen pertanyent al seu Space; seleccionar una Skill no canvia aquest límit.

## Creació i manteniment de Skills

Obriu el **menú de l'organització** → **Skills** → **New Skill**. A la pestanya **Skill**, introduïu **Name**, **Slug**, una **Description** opcional i les instruccions reutilitzables en **Markdown**. Utilitzeu la pestanya **Files** per a qualsevol fitxer de suport del paquet i, a continuació, seleccioneu **Create Skill**.

L'Slug utilitza lletres minúscules, números i guions, comença amb una lletra o un número, i és el que els usuaris escriuen després de `/`.

Crear o editar una Skill genera un esborrany. A la pàgina de detall de la Skill, les modificacions es desen automàticament; seleccioneu **Publish Draft** per verificar i publicar l'esborrany. Si la verificació falla, utilitzeu els diagnòstics que es mostren per corregir l'esborrany i torneu-lo a publicar.

Utilitzeu **History** per inspeccionar revisions, restaurar una revisió substituïda o descartar un esborrany mutable quan aquestes accions estiguin disponibles. **Disable Skill** la retira del descobriment per part d'agents externs i de la resolució de les Automations sense eliminar-ne l'historial de revisions; **Enable Skill** la torna a fer disponible.

## Creeu o editeu una Skill amb MCP

Utilitzeu un client MCP extern connectat per a l'autoria centrada en paquets. Crideu `skills.get` abans d'editar una Skill existent. Utilitzeu `skills.create` per a un paquet nou o `skills.create_candidate` per a una revisió basada en la revisió activa actual.

Els paquets petits es poden proporcionar inline. Per a paquets més grans, crideu `skills.create_package_upload_session`, pugeu els objectes sol·licitats i acabeu amb `skills.finalize_package_upload_session`. Si la verificació s'ha ajornat, crideu `skills.publish_revision`. Consulteu periòdicament `skills.get` per obtenir la sol·licitud de cicle de vida acceptada i el seu resultat de verificació o promoció.

Publicar una Skill no crea, revisa ni activa cap Automation; utilitzeu explícitament el cicle de vida d'Automations d'MCP quan en necessiteu una.

## Comenceu a partir d'una plantilla de Skill

La pàgina **Skills** inclou **Skill Templates**. Cerqueu o filtreu el catàleg, previsualitzeu una plantilla i seleccioneu **Copy Skill**. La còpia esdevé una Skill de l'organització que es pot editar i publicar com qualsevol altra Skill.

## Skills i Automations

Una Skill defineix com fer una feina reutilitzable. No decideix quan s'executa aquesta feina.

Utilitzeu una Automation quan una feina s'hagi d'executar manualment, segons una planificació o en resposta a un esdeveniment. Una Automation pot fixar una o més revisions de Skills perquè la mateixa implementació es reutilitzi entre execucions.


## Related topics

- [MCP](/docs/ca/mcp-server.md)
- [Automations](/docs/ca/automations.md)
- [Benvinguda](/docs/ca/agents/introduction.md)


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