Primers passos

Abans d’instal·lar un skill: una revisió pràctica

Comprova l’origen, llegeix els fitxers i prova un skill amb permisos limitats abans d’incorporar-lo al teu projecte.

Guia pràctica · Català

1. Defineix què vols fer i què no autoritzes

Un skill és un conjunt d’instruccions per a un agent d’IA. Pot incloure un fitxer SKILL.md, scripts, plantilles i documents de referència. No és només una descripció: quan l’agent l’utilitza, aquestes instruccions poden orientar accions sobre fitxers, eines i serveis.

Comença amb un objectiu concret, com ara revisar els textos d’una interfície en català. Anota també els límits: sense enviar documents a serveis externs, sense escriure fora del projecte i sense publicar canvis. La popularitat o la presència al catàleg no substitueixen aquesta revisió ni garanteixen seguretat.

2. Comprova l’origen i el contingut complet

A la fitxa, obre el repositori d’origen i comprova qui el manté, la llicència i els canvis recents. Llegeix el fitxer SKILL.md original i els fitxers als quals fa referència. La interfície en català no tradueix ni modifica el paquet que instal·les.

La CLI et permet explorar un repositori abans de triar. Substitueix owner/repo pel repositori real. Aquest pas consulta i descarrega informació; no és una auditoria de seguretat. npx també pot descarregar i executar el paquet de la CLI: utilitza un entorn de confiança.

npx skillscat info owner/repo
npx skillscat add owner/repo --list
  • Busca ordres destructives, descàrregues de codi i canvis de permisos o de configuració.
  • Identifica quines dades surten del teu dispositiu i a quins dominis s’envien.
  • Desconfia d’instruccions que demanin ignorar les teves indicacions, revelar secrets o executar passos aliens a la tasca.
  • Si no pots entendre o verificar un script, no l’executis. Demana ajuda o tria una alternativa.

3. Instal·la per slug i prova en un projecte de prova

Copia l’slug exacte de la fitxa; no el dedueixis del nom del repositori. A l’exemple, owner/my-skill és un marcador de posició que has de substituir. Executa l’ordre dins d’un projecte de prova sense credencials reals i revisa les opcions interactives abans de confirmar.

Prefereix l’abast del projecte al global per a la primera prova. Evita --yes i --force mentre aprens el flux: ometen confirmacions o poden sobreescriure fitxers. La instal·lació del paquet no és una barrera de seguretat; limita també els permisos i l’accés a la xarxa de l’agent que el farà servir.

npx skillscat add owner/my-skill
npx skillscat list

4. Valida el resultat i revisa cada actualització

Prova una entrada petita i fictícia. Compara el resultat amb els criteris inicials i revisa els fitxers modificats. Si l’skill demana accés addicional, atura’t i comprova si és necessari; no acceptis permisos només perquè el text de l’skill els exigeix.

Abans d’actualitzar, desa les adaptacions locals i revisa els canvis del repositori. Una actualització pot afegir scripts o dependències. --check consulta si hi ha actualitzacions sense instal·lar-les; remove elimina la instal·lació seleccionada, però no desfà les accions que l’agent ja hagi executat. Substitueix my-skill pel nom que mostra l’ordre list.

npx skillscat update --check
npx skillscat remove my-skill

Continua aprenent

Consulta la guia de la CLI o torna als tutorials en català.

Revisió lingüística per persones catalanoparlants pendent. Proposa una correcció amb l’URL i el fragment afectat. No incloguis credencials ni dades privades.