> ## 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. # Skill > Crea pacchetti riutilizzabili per agenti esterni e Automation Le Skill sono pacchetti riutilizzabili di istruzioni e file di supporto opzionali. Consentono al tuo team di definire una sola volta un modo ripetibile per completare un'attività e poi applicarlo in modo coerente in tutto Flowglad. Ogni Skill ha un nome, uno slug per lo slash command, una descrizione e istruzioni scritte in Markdown. I file di supporto possono fornire contesto aggiuntivo o risorse necessarie per seguire tali istruzioni. ## Usa Flowglad come libreria di Skill del tuo team Flowglad conserva ogni Skill come pacchetto con versioni. La pubblicazione di una modifica crea una nuova revisione invece di sostituire sul posto il pacchetto precedente. Gli amministratori dell'organizzazione possono aprire la **History** di una Skill per esaminarne le revisioni, confrontare le modifiche, ripristinare una revisione precedente o scartare una bozza, quando queste azioni sono disponibili. In questo modo il tuo team dispone di un unico luogo governato per gestire istruzioni riutilizzabili, preservando quale versione era attiva in un determinato momento. Le revisioni in bozza e quelle rifiutate non sostituiscono la versione attiva. ### Gestire le Skill tramite MCP Dopo aver connesso il server MCP di Flowglad, un agente può esaminare e gestire per te la libreria di Skill della tua organizzazione: * `skills.list` restituisce le Skill visibili alla connessione. * `skills.get` restituisce i metadati dell'ultima revisione e di quella attiva di una Skill. * `skills.create` invia un nuovo pacchetto Skill. * `skills.create_candidate` invia una nuova revisione di una Skill esistente. * `skills.publish_revision` verifica e pubblica una revisione differita. * `skills.create_package_upload_session` e `skills.finalize_package_upload_session` trasferiscono i pacchetti troppo grandi per essere inviati inline. * `skills.get` riporta il risultato della verifica e della promozione della richiesta accettata. La creazione o l'aggiornamento delle Skill richiede il permesso `skills:write` sia sulla membership dell'organizzazione del membro del team sia sul grant della connessione MCP. Se aggiungi il permesso dopo aver connesso il server, riconnetti Flowglad MCP e autorizza `skills:write` affinché gli strumenti di scrittura diventino disponibili. **Permessi:** gli amministratori hanno accesso all'authoring delle Skill per impostazione predefinita. Per concedere lo stesso accesso a un Contributor, apri **Settings** → **Team**, seleziona il membro del team e abilita **Skill Authoring**. In questo modo concedi il permesso di creare e aggiornare le Skill dell'organizzazione senza rendere il membro del team un amministratore. ## Caricare le Skill di Flowglad MCP nel tuo agente Il server MCP di Flowglad annuncia `io.modelcontextprotocol/skills` durante l'inizializzazione MCP. Questo comunica ai client compatibili che il server implementa i metodi Skill per agenti `skills/list` e `skills/get`. Ogni Skill restituita include URI di risorse `skill://` e digest del contenuto; i client possono recuperare i file con `resources/read`. Connettere il server non garantisce che un client chiamerà `skills/list` o installerà i pacchetti restituiti. Il supporto varia a seconda del client. Aggiungi un'istruzione di avvio a ChatGPT / Codex o Claude quando vuoi che l'agente aggiorni il registry di Flowglad all'inizio di ogni sessione. **Nomenclatura MCP:** i nomi sono intenzionalmente diversi. `skills.list` con il punto è uno strumento di Flowglad per i record delle Skill con versioni della tua organizzazione. `skills/list` con la barra è un metodo di estensione del protocollo MCP per individuare i pacchetti Skill destinati agli agenti. ### Aggiungere l'istruzione di avvio Crea una sola volta la directory di destinazione prima di avviare una nuova sessione, quindi aggiungi il blocco di istruzioni corrispondente riportato di seguito. #### ChatGPT / Codex Crea la directory di destinazione di ChatGPT / Codex con `mkdir -p ~/.agents/skills`. Inserisci il blocco seguente in `~/.codex/AGENTS.md` per applicarlo a ogni progetto, oppure nel file `AGENTS.md` di un repository per condividerlo con il team di quel repository. ```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//`. 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 la directory di destinazione di Claude con `mkdir -p ~/.claude/skills`. Inserisci il blocco seguente in `~/.claude/CLAUDE.md` per applicarlo a ogni progetto, oppure nel file `CLAUDE.md` di un repository per condividerlo con il team di quel repository. ```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//`. 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. ``` Puoi chiedere a ChatGPT / Codex o a Claude di aggiungere il blocco appropriato al proprio file di istruzioni a livello utente. Esamina la modifica proposta prima di accettarla, perché quel file influisce sulle sessioni future. L'istruzione è un bootstrap dell'agente di tipo best-effort; se il tuo ambiente deve aggiornare le Skill in modo deterministico, implementa la stessa sincronizzazione in un hook `SessionStart` attendibile o nell'integrazione del tuo client MCP. ## Dove vengono usate le Skill Le Skill hanno attualmente due consumatori: * Gli agenti esterni compatibili individuano e sincronizzano i pacchetti abilitati tramite Flowglad MCP, quindi li associano automaticamente o li invocano per nome. * Le Automation fissano una revisione esatta e pubblicata di una Skill come risorsa di codice OWS `skill-revision`. L'Automation seleziona un percorso del pacchetto e un entrypoint; gli step degli agenti ricevono solo le Skill autorizzate dal set di capability sigillato dell'esecuzione. Il primo percorso fornisce istruzioni riutilizzabili a un agente esterno. Il secondo fornisce codice immutabile e file di supporto a un'esecuzione ripetibile di un'Automation. Le Skill pubblicate valgono per l'intera organizzazione, quindi un'Automation autorizzata può selezionare la stessa revisione di una Skill in qualsiasi Space. L'Automation che la utilizza e le sue esecuzioni restano di proprietà del rispettivo Space; selezionare una Skill non modifica questo confine. ## Creare e gestire le Skill Apri il **menu dell'organizzazione** → **Skills** → **New Skill**. Nella scheda **Skill**, inserisci **Name**, **Slug**, la **Description** facoltativa e le istruzioni riutilizzabili in **Markdown**. Usa la scheda **Files** per gli eventuali file di supporto del pacchetto, quindi seleziona **Create Skill**. Lo Slug usa lettere minuscole, numeri e trattini, inizia con una lettera o un numero ed è ciò che gli utenti digitano dopo `/`. La creazione o la modifica di una Skill produce una bozza. Nella pagina di dettaglio della Skill le modifiche vengono salvate automaticamente; seleziona **Publish Draft** per verificare e pubblicare la bozza. Se la verifica non riesce, usa la diagnostica visualizzata per correggere la bozza e pubblicarla di nuovo. Usa **History** per esaminare le revisioni, ripristinare una revisione sostituita o scartare una bozza modificabile, quando queste azioni sono disponibili. **Disable Skill** la rimuove dall'individuazione da parte degli agenti esterni e dalla risoluzione delle Automation senza eliminare la cronologia delle revisioni; **Enable Skill** la rende di nuovo disponibile. ## Creare o modificare una Skill con MCP Usa un client MCP esterno connesso per un authoring incentrato sui pacchetti. Chiama `skills.get` prima di modificare una Skill esistente. Usa `skills.create` per un nuovo pacchetto oppure `skills.create_candidate` per una revisione basata sulla revisione attiva corrente. I pacchetti di piccole dimensioni possono essere forniti inline. Per i pacchetti più grandi, chiama `skills.create_package_upload_session`, carica gli oggetti richiesti e concludi con `skills.finalize_package_upload_session`. Se la verifica è stata differita, chiama `skills.publish_revision`. Interroga periodicamente `skills.get` per conoscere la richiesta di ciclo di vita accettata e il relativo risultato di verifica o promozione. La pubblicazione di una Skill non crea, revisiona né attiva un'Automation; usa esplicitamente il ciclo di vita MCP delle Automation quando ne serve una. ## Partire da un template di Skill La pagina **Skills** include **Skill Templates**. Cerca o filtra il catalogo, visualizza l'anteprima di un template e seleziona **Copy Skill**. La copia diventa una Skill dell'organizzazione che può essere modificata e pubblicata come qualsiasi altra Skill. ## Skill e Automation Una Skill definisce come eseguire un lavoro riutilizzabile. Non decide quando quel lavoro viene eseguito. Usa un'Automation quando il lavoro deve essere eseguito manualmente, secondo una pianificazione o in risposta a un evento. Un'Automation può fissare una o più revisioni di Skill, in modo che la stessa implementazione venga riutilizzata tra le esecuzioni. ## Related topics - [MCP](/docs/it/mcp-server.md) - [Automations](/docs/it/automations.md) - [Benvenuto](/docs/it/agents/introduction.md) This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.