> For clean Markdown of any page, append .md to the page URL. > For a complete documentation index, see https://docs.userbot.ai/llms.txt. > For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.userbot.ai/_mcp/server. # Creare una skill Una skill si crea quando una competenza che oggi vive nella testa di qualcuno deve diventare disponibile in ogni conversazione. Ci sono tre modi per farne una, e si scelgono in base a cosa hai già in mano. ## Le vie Vai in **Personalizza → Skill**. **Aggiungi skill** apre subito il modulo **Scrivi le istruzioni della skill**; la freccia accanto (**Altre opzioni di creazione**) apre il menu con tutte e tre le vie: ![Il menu della freccia accanto ad Aggiungi skill: Scrivi le istruzioni, Crea con la chat e Carica una skill, ognuna con una riga che dice per quale situazione è pensata](/_fern-img/49f933a3e661a7a0b7ede763745f500de1419913898eca189158e49d46ba1837.webp) #### Scrivi le istruzioni Un modulo con nome, descrizione, istruzioni e un'icona facoltativa. La via giusta quando sai già cosa scrivere e vuoi farlo in due minuti. #### Crea con la chat L'AI ti intervista: cosa deve fare la skill, quando attivarsi, con quali integrazioni. Poi ti propone nome, descrizione e istruzioni. La via giusta quando hai un'idea ma non sai ancora formularla. #### Carica una skill Importi un file `SKILL.md`, uno `.zip` o un pacchetto `.skill`. La via giusta quando la competenza è già scritta da qualche parte, con i suoi allegati. ## Scriverla nel modulo #### Premi Aggiungi skill Si apre il modulo **Scrivi le istruzioni della skill**: a sinistra nome, descrizione e istruzioni, a destra le **Integrazioni**. ![Il modulo Scrivi le istruzioni della skill: icona e nome in alto, poi la descrizione e le istruzioni con il pulsante Ottimizza, e a destra il pannello Integrazioni con Aggiungi integrazioni](/_fern-img/7f9d085e185f69fb92a40d86d44ca5b5cc140c59336eec789a88268294a1b859.webp) #### Dai un nome e scrivi la descrizione Il nome è quello che si scrive dopo la **@**. La descrizione dice **quando** l'AI deve usare la skill: come scriverla sta più sotto. ![Il nome della skill e la descrizione compilati, con i contatori dei caratteri e sotto la nota L'AI decide se usare questa skill in base alla descrizione](/_fern-img/1c92c8132078b162c64903233e4cb4084a7a524c0fba74102b79349548454aa5.webp) #### Scrivi le istruzioni Cosa deve fare l'AI quando la skill si attiva. **Schermo intero** ti dà più spazio. ![Il campo Istruzioni con tre regole scritte, Ottimizza in basso a sinistra e il pulsante Schermo intero evidenziato in basso a destra](/_fern-img/acbbbdf5a6561db7cda78df271ce173dee07bf720dd5f9326f432c1af59541bd.webp) #### Aggiungi le integrazioni, se servono **Aggiungi integrazioni** nel pannello a destra. Si apre il catalogo delle app: quelle già collegate le aggiungi, le altre le colleghi al volo con **Collega**. Si usano solo quando la skill si attiva. ![La finestra Aggiungi integrazioni: la ricerca Cerca app, le app del catalogo ognuna con Collega, e in fondo Fatto](/_fern-img/e33908ab450641fa2f6eb68024ab1a640fb17147a038d18a5dbb9c42d631b472.webp) #### Premi Crea Il pulsante si accende quando nome e istruzioni sono compilati. La skill compare fra le **Installate**, privata finché non la condividi. ![In fondo al modulo il pulsante Crea acceso ed evidenziato, accanto ad Annulla](/_fern-img/9e44d8cd862390898ca6794484d13f61bddf7941e55cc33ec87a5ba258218401.webp) Se non vedi **Aggiungi skill**, il tuo ruolo non prevede la creazione di skill: chiedi a chi amministra l'area di lavoro. ## Cosa scriverci dentro Le tre vie arrivano allo stesso risultato: una skill fatta di tre pezzi. ### Il nome Corto e riconoscibile. È quello che scrivi dopo la **@** quando vuoi forzarla, e quello che i colleghi cercano nell'elenco. Massimo 64 caratteri, ed è obbligatorio. ### La descrizione È il pezzo che conta di più, e il più sbagliato. Non deve dire cosa fa la skill: deve dire **quando l'AI deve usarla**. È l'unico testo su cui l'AI decide se caricarla. Massimo 1.024 caratteri. Il pulsante **Ottimizza** riscrive la descrizione rendendola più specifica sul momento di attivazione, mantenendo il significato. Usalo dopo aver scritto la tua versione, non al posto suo. ### Le istruzioni Il corpo della skill: cosa deve fare l'AI quando la skill si attiva. Sono obbligatorie, fino a 50.000 caratteri; **Schermo intero** ti dà più spazio per scriverle. La regola è una sola: **concrete e verificabili**, non principi generici. | Istruzione vaga | Istruzione che funziona | | ------------------------------ | ------------------------------------------------------------------------------- | | «Scrivi in modo professionale» | «Niente esclamativi, niente domande retoriche, massimo 15 parole per frase» | | «Controlla i dati» | «Ricalcola ogni totale citato nel documento e segnala le differenze oltre l'1%» | | «Sii esaustivo» | «Struttura in tre sezioni: risultati, blocchi, prossimi passi» | Se la skill riguarda un formato preciso, includi un esempio di ingresso e di uscita: vale più di tre paragrafi. Anche qui **Ottimizza** rende concreto ciò che hai scritto in modo troppo astratto. Scrivile immaginando di spiegarle a un collega competente ma appena arrivato, che non conosce le vostre abitudini: tutto quello che daresti per scontato con un collega esperto va messo per iscritto. ## Collegare le integrazioni Nel pannello laterale del modulo trovi **Integrazioni**. Le app collegate che aggiungi qui diventano disponibili all'AI **quando quella skill si attiva**, e solo allora. È il modo per dare a una competenza gli strumenti che le servono senza tenerli sempre accesi: una skill che prepara i verbali può avere accesso al calendario; una che prepara l'outreach, al CRM. Se un'app non è ancora collegata, la colleghi dallo stesso pannello. Quando l'AI ti chiede conferma prima di agire su un'app sta in [Conferme prima di agire](/conferme-azioni). ## Allegare file alla skill Una skill può portare con sé dei file: un modello di documento, le linee guida di brand, un logo, un foglio di calcolo di riferimento. Quando la skill si attiva, quei file sono già a disposizione dell'AI, che li usa per produrre il risultato, per esempio impaginando un report sul vostro modello invece che su uno generico. I file si gestiscono aprendo la skill e premendo **Modifica**: **Nuovo file** ne aggiunge uno, e quelli di testo si modificano lì. I file binari, come immagini e font, restano visibili ma non modificabili. ## Caricare una skill già scritta Se la competenza esiste già come documento, **Carica una skill** la importa direttamente. In alternativa trascina il file sulla pagina **Skill**: compare «Rilascia per importare una skill» e ogni file diventa una skill nuova. Un formato diverso viene rifiutato con un messaggio. | Formato | Cosa contiene | | ---------- | ------------------------------------------------------------------------------------- | | `SKILL.md` | Solo le istruzioni. Nome e descrizione si ricavano dall'intestazione del file, se c'è | | `.zip` | Un `SKILL.md` più i file di contorno: modelli, immagini, font | | `.skill` | Lo stesso di uno `.zip`, già confezionato | > **Info** > > Limiti dell'archivio: **20 MB** in totale, **5 MB** per singolo file, **200** > file al massimo. Uno `.zip` senza `SKILL.md` al suo interno non viene > importato. ## Renderla disponibile al team Appena creata, una skill è privata: la vedi e la usi solo tu. Per condividerla, apri **Condividi** dal menu della scheda: puoi aggiungere persone e gruppi, e nell'**Accesso generale** aprirla a tutta l'area di lavoro. Ognuna delle due cose richiede un permesso del tuo ruolo; se manca, compare «Non è stato possibile cambiare la condivisione.» Una skill condivisa entra nel raggio d'azione dell'AI solo **per chi vi ha accesso**: la skill privata di un collega non influenza le tue conversazioni. > **Warning** > > Prima di condividere, rileggi le istruzioni pensando a chi le leggerà. Sono > visibili a chiunque abbia accesso alla skill, comprese eventuali soglie, prezzi > o criteri interni che ci hai scritto dentro. Chi amministra l'area di lavoro può **bloccare** una skill per i membri, dalle impostazioni: da quel momento compare l'etichetta **Bloccata** e dalla pagina **Skill** nessuno può disattivarla o eliminarla, amministratori compresi. Si usa per le competenze che devono valere per tutti, come un controllo obbligatorio prima di inviare qualcosa a un cliente. ## Modificarla e scaricarla Apri la skill e premi **Modifica**. Nel file `SKILL.md` cambi descrizione e istruzioni; **Migliora descrizione** e **Migliora istruzioni** le fanno riscrivere all'AI in forma più chiara. Conferma con **Salva**: **Annulla**, o tornare in **Anteprima** senza salvare, scarta le modifiche al `SKILL.md`. Gli altri file di testo si salvano quando esci dal campo. **Scarica** salva la skill sul tuo computer: un file `.md`, oppure uno `.zip` se la skill ha anche altri file. Lo stesso file si reimporta con **Carica una skill**, ed è il modo per spostarla in un'altra area di lavoro o tenerne una copia prima di cambiarla. Per eliminarla usa **Elimina skill** dal menu della scheda; Userbot chiede conferma. ## Provarla Apri la skill e usa **Prova in chat**: parte una conversazione che la richiama esplicitamente e ti chiede il contesto che le manca. ![Una skill aperta, qui Skill Creator: a sinistra l'elenco dei suoi file, che qui contiene solo SKILL.md, al centro le istruzioni leggibili per intero, in alto a destra i comandi della skill fra cui Prova in chat](/_fern-img/e1a14bebb53fd107b4bb050b8158fb2aa32caac35d772c4bf7da410af947d7c3.webp) Se il risultato non è quello che volevi, torna sulle istruzioni; se la skill non si attiva da sola quando dovrebbe, torna sulla descrizione.