CLI de SkillsCat

Inici ràpid

Necessites un terminal amb Node.js i npx disponibles. npx pot descarregar i executar la CLI: revisa el paquet i utilitza un entorn de confiança. Aquesta guia és en català; les ordres, els identificadors i els missatges del programa no es tradueixen.

Executa npx skillscat --help per consultar les opcions de la versió que utilitzes. Les ordres que instal·len, actualitzen, eliminen o publiquen contingut tenen efectes reals: llegeix les confirmacions i no les executis només per provar la documentació.

npx skillscat search "code review"
npx skillscat info owner/repo
npx skillscat add owner/my-skill
npx skillscat add owner/path/to/skill
npx skillscat update --check
npx skillscat list

Cerca i inspecciona

npx skillscat search "revisió de textos"
npx skillscat search "localization" --limit 10
npx skillscat info owner/repo
npx skillscat add owner/repo --list

Substitueix owner/repo pel repositori real. info i --list ajuden a veure què conté un repositori abans d’instal·lar. Llegeix també els fitxers d’origen; aquestes ordres no auditen els scripts ni demostren que siguin segurs.

Instal·la amb l’slug exacte

npx skillscat add owner/my-skill
npx skillscat add owner/my-skill --agent openclaw

owner/my-skill és un exemple: substitueix-lo per l’slug de la fitxa. Aquesta és la via preferida per als skills ja publicats, també quan provenen d’un repositori amb diversos skills o d’una carpeta imbricada. No dedueixis l’slug a partir del nom del repositori.

Segueix les indicacions interactives per triar l’agent i l’abast de la instal·lació. --agent selecciona un agent concret i --global instal·la al directori de l’usuari en lloc del projecte. Per a la primera prova, prefereix un projecte aïllat. --force pot sobreescriure fitxers i --yes omet confirmacions; no són opcions necessàries per començar.

Si desenvolupes un paquet propi, npx skillscat add ./el-meu-skill permet instal·lar una carpeta local. Si se’t proposa publicar-la, tracta aquesta proposta com una acció separada i confirma-la només si vols compartir el contingut.

Consulta i gestiona les instal·lacions

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

Fes servir el nom de la instal·lació que mostra list en lloc de my-skill. --check comprova si hi ha actualitzacions sense instal·lar-les. Abans d’actualitzar, desa les adaptacions locals i revisa els canvis del paquet. Eliminar un skill no reverteix els efectes de les accions que l’agent ja hagi executat.

Per migrar contingut existent de .agents a OpenClaw o actualitzar la mateixa CLI:

npx skillscat convert openclaw --from agents
npx skillscat self-upgrade

Inicia sessió i comprova la configuració

npx skillscat login
npx skillscat whoami
npx skillscat config list
npx skillscat config get registry
npx skillscat config set registry https://skills.cat/registry
npx skillscat config delete registry
npx skillscat logout

login inicia el flux d’autenticació; segueix les indicacions del terminal i comprova el domini abans d’autoritzar. Cal una sessió vàlida per publicar, proposar repositoris o accedir a contingut privat. No enganxis tokens en incidències, captures ni exemples compartits.

El registre natiu és https://skills.cat/registry. No el confonguis amb l’entrada compatible amb ClawHub, https://skills.cat/openclaw. No cal canviar el registre per triar la llengua del lloc web.

Proposa un repositori o publica un paquet propi

npx skillscat submit https://github.com/owner/repo
npx skillscat publish --help
npx skillscat publish ./el-meu-skill

submit proposa un repositori públic de GitHub per a la indexació. publish puja un paquet local i mostra una vista prèvia abans de confirmar. Revisa el nom, l’slug, els fitxers i la visibilitat; aquesta pot dependre del compte o de l’organització, i no has de donar per fet que el paquet serà públic. L’slug no es pot canviar després de publicar.

Comprova les llicències i elimina credencials i dades personals. No executis totes dues ordres si només necessites una de les dues vies. Consulta el tutorial de creació per preparar un exemple en català.

Pots publicar un paquet privat o retirar-ne un que ja hagis publicat:

npx skillscat publish ./my-skill --private
npx skillscat unpublish owner/my-skill

unpublish només s’aplica als skills privats publicats.

Referència de les ordres

Consulta npx skillscat --help per veure les ordres disponibles i npx skillscat add --help per llegir les opcions d’instal·lació de la versió que utilitzes.

Ordre	Quan utilitzar-la
`npx skillscat search "code review"`	Cerca skills públics a partir d’una tasca.
`npx skillscat info owner/repo`	Inspecciona els skills d’un repositori abans d’instal·lar.
`npx skillscat add owner/my-skill`	Instal·la un skill amb l’slug publicat exacte.
`npx skillscat add owner/path/to/skill`	Instal·la un skill publicat amb una ruta imbricada.
`npx skillscat update --check`	Comprova les actualitzacions sense sobreescriure la instal·lació.
`npx skillscat login`	Autentica’t per accedir a skills privats o publicar.
`npx skillscat publish ./path/to/skill`	Publica un paquet local.

Si alguna cosa falla

No es troba l’skill: copia de nou l’slug exacte i comprova que la fitxa sigui accessible.
Accés denegat: comprova la sessió amb whoami i els permisos sobre el paquet privat.
L’agent no el detecta: revisa l’agent seleccionat, el directori del projecte, el nom SKILL.md i les instruccions de recàrrega del teu agent.
Resultat inesperat: revisa les dependències i les instruccions originals; instal·lar un paquet no configura automàticament les eines externes que necessita.

Ajuda’ns a millorar aquesta guia

La revisió lingüística per persones catalanoparlants està pendent. Comunica un error o proposa una correcció amb l’URL i el fragment afectat, sense dades privades. Consulta també què inclou la versió en català i què queda pendent.