SKILL / COME INIZIARE

Come installare e usare una skill

Dalla scheda al primo utilizzo, con il percorso guidato di skills.sh. Un comando copiato non è ancora un’installazione.

Prima: dove vuoi usarla?

Serve un agente che supporti skill locali e l’accesso al suo ambiente di lavoro. Una normale chat nel browser non significa automaticamente che tu possa installare file sul computer.

Per il percorso qui sotto serve Node.js con npm, che fornisce npx. Puoi controllare dal terminale con node --version e npm --version. Se mancano, segui la documentazione di Node.js.

1. Scegli e copia il comando

Apri il terminale nella cartella del progetto. Per scegliere le skill di Repo Forge:

npx skills add peorthyr/repo-forge

Segui le scelte del CLI: componenti, agente e destinazione. Per una sola skill:

npx skills add peorthyr/repo-forge --skill ai-project-scan

Il sito ti copia il comando. A eseguirlo nell’ambiente di lavoro sei tu; dal browser non possiamo dire che l’installazione sia riuscita.

2. Controlla che l’agente la riconosca

Verifica l’esito nel terminale e cerca la skill nell’elenco o nella modalità di selezione del tuo agente. Se serve, riapri la sessione seguendo le indicazioni del client. Non tutti usano lo stesso comando con slash.

3. Prova una richiesta piccola

Usa ai-project-scan su questo repository in modalità quick. Leggi i documenti di governance e proponi il prossimo passo senza modificare file.

Controlla che il report rimandi ai file letti e che non ci siano modifiche. Per le altre skill leggi prima la scheda: alcune scrivono documenti. Installare una skill e usarla sono due passaggi diversi.

Progetto o personale?

L’ambito progetto la rende disponibile nel contesto scelto. Il CLI offre anche --global per l’uso personale fra progetti. Per cominciare teniamo il percorso guidato.

Attenzione alla scorciatoia --all: comprende tutte le skill e tutti gli agenti, senza prompt. Non significa soltanto “tutta questa raccolta”.

Aggiornare e rimuovere

npx skills --help
npx skills list
npx skills update ai-project-scan
npx skills remove

list elenca le installazioni. Con update puoi indicare la skill da aggiornare; senza nome può aggiornarne più di una. remove offre la selezione di quelle da rimuovere. Controlla sempre l’ambito.

Il comando installa dalla fonte corrente. La revisione citata in una scheda indica ciò che abbiamo letto o provato: un aggiornamento non aggiorna automaticamente quelle evidenze.

Se qualcosa non torna

  • npx non disponibile: verifica Node/npm e il terminale.
  • Fonte non raggiungibile: controlla connessione e URL del repository.
  • Skill assente nell’agente: controlla agente, destinazione e modalità di caricamento del client.
  • Risultato diverso dall’esempio: confronta ambiente, versione e input. L’esempio è qualcosa da controllare, non una garanzia.

Riferimenti: skills.sh e documentazione del CLI skills.

Torna al catalogo →

A cura di Matteo Bononi ·