Skip to main content
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.
AGENTS.md

​
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.
CLAUDE.md
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.