Si ja utilitzes un client compatible amb ClawHub

SkillsCat ofereix una entrada compatible amb ClawHub. El lloc és https://skills.cat i el registre compatible és https://skills.cat/openclaw. Configura’ls seguint les opcions del teu client; no pressuposis que comparteix la configuració de la CLI nativa de SkillsCat.

clawhub search "seo audit" --site https://skills.cat --registry https://skills.cat/openclaw
clawhub inspect <owner>~<skill> --site https://skills.cat --registry https://skills.cat/openclaw
clawhub install <owner>~<skill> --site https://skills.cat --registry https://skills.cat/openclaw
clawhub update <owner>~<skill> --site https://skills.cat --registry https://skills.cat/openclaw
clawhub publish ./my-skill --slug <owner>~<skill> --version 1.0.0 --site https://skills.cat --registry https://skills.cat/openclaw

Els slugs compatibles utilitzen ~, com ara owner~skill o owner~path~to~skill, també en publicar. Els clients poden descobrir l’API a https://skills.cat/.well-known/clawhub.json.

Instal·la des de l’espai de treball d’OpenClaw

Primer revisa el paquet i copia l’slug exacte de la fitxa. Obre un terminal dins de l’espai de treball on vols utilitzar-lo i substitueix el marcador de posició de l’exemple:

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

La CLI instal·la el paquet complet al format de directoris d’OpenClaw. Això no executa per tu tots els passos de configuració indicats pel seu autor ni concedeix automàticament permisos perquè l’agent executi scripts.

npx skillscat info <owner>/<repo>
npx skillscat add <slug> --agent openclaw
npx skillscat add <slug> --agent openclaw --global
npx skillscat convert openclaw --from agents

convert openclaw --from agents permet migrar contingut existent de .agents. Si només coneixes el repositori, inspecciona’l abans d’instal·lar amb l’slug publicat.

Configura el lloc i el registre

Per a la via nativa de SkillsCat, l’ordre amb --agent openclaw és suficient per seleccionar el format d’instal·lació: no cal substituir el registre natiu només per fer servir OpenClaw. Els dos punts d’entrada tenen finalitats diferents.

Per reutilitzar la configuració amb clawhub, defineix aquestes variables d’entorn. Per a una sola ordre, pots continuar utilitzant --site i --registry.

export CLAWHUB_SITE=https://skills.cat
export CLAWHUB_REGISTRY=https://skills.cat/openclaw

clawhub search "calendar"
clawhub install <owner>~<skill>
clawhub update <owner>~<skill>

Directori del projecte o de l’usuari

Projecte: els paquets s’instal·len dins del directori skills/ de l’espai de treball.
Global: amb --global, el directori habitual és ~/.openclaw/skills/.

Per treballar en equip, prefereix l’abast del projecte i documenta els requisits. Comprova que SKILL.md i els fitxers associats siguin presents. Després recarrega els skills o reinicia la sessió segons la versió d’OpenClaw que utilitzis.

Abast	Directori	Quan utilitzar-lo
Projecte	`<workspace>/skills/<folder-name>/`	Opció recomanada per a la col·laboració i el control de versions.
Global	`~/.openclaw/skills/<folder-name>/`	Reutilització personal entre projectes.

Paquets privats, permisos i secrets

Els paquets privats requereixen una sessió o un token amb els permisos corresponents. Inicia sessió amb la CLI que utilitzes i no assumeixis que una credencial d’un altre servei et donarà accés. No escriguis tokens en un SKILL.md compartit ni els publiquis en una incidència.

Abans de permetre que l’agent faci servir el paquet, comprova els scripts, les peticions de xarxa i els fitxers que pot llegir. Utilitza una prova sense secrets reals i concedeix només els permisos necessaris.

clawhub login --site https://skills.cat
clawhub login --token <skillscat-api-token> --site https://skills.cat --registry https://skills.cat/openclaw
npx skillscat login
npx skillscat add <slug> --agent openclaw

La sessió de clawhub amb SkillsCat configura el registre compatible. Pots gestionar tokens amb els permisos read, write i publish a la pàgina de tokens d’API. La CLI nativa manté la seva pròpia autenticació i no modifica la configuració de clawhub. Per a fluxos privats més complexos, utilitza la CLI nativa.

Comprovacions si l’skill no apareix

Confirma el directori actual i si has fet una instal·lació de projecte o global.
Revisa que el paquet contingui SKILL.md i que les rutes relatives siguin vàlides.
Comprova que la sessió d’OpenClaw utilitzi aquest espai de treball i hagi recarregat els skills.
Si la descàrrega falla, comprova l’slug, la visibilitat i els permisos del compte abans de repetir-la.
Si falten eines o credencials, segueix les instruccions originals sense exposar secrets a l’agent innecessàriament.

Continua amb la guia de la CLI o la llista de revisió abans d’instal·lar.

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.