Contribucions

Crea i comparteix un skill amb instruccions en català

Prepara un SKILL.md clar, prova el paquet localment i tria entre proposar un repositori públic o publicar un paquet propi.

Guia pràctica · Català

1. Tria una tasca petita i descriu-ne els límits

Un primer skill pot ajudar a revisar textos en català sense reescriure codi. Explica quan s’ha d’utilitzar, quines entrades necessita i com ha de presentar el resultat. Demana explícitament que no publiqui ni modifiqui fitxers sense autorització.

Crea una carpeta amb SKILL.md. El següent exemple és un punt de partida, no una certificació de compatibilitat amb tots els agents. Mantén les claus tècniques name i description; redacta les instruccions i la descripció en català.

---
name: revisio-catala
description: Revisa textos d’interfície en català i proposa correccions justificades.
---

# Revisió de textos en català

## Quan s’ha d’utilitzar
Quan l’usuari demani revisar textos d’una interfície.

## Passos
1. Demana el públic, el to i el glossari del projecte.
2. Conserva variables, rutes, etiquetes i ordres.
3. Proposa una taula amb original, proposta i motiu.
4. Marca els dubtes perquè els revisi una persona.

## Límits
No canviïs fitxers ni publiquis res sense autorització.
No enviïs contingut a serveis externs.

2. Revisa els fitxers i prova el paquet localment

Si afegeixes plantilles o exemples, utilitza rutes relatives i comprova que tots els fitxers referenciats s’inclouen al paquet. No hi posis claus API, credencials ni documents de clients. Revisa la llicència dels materials que reutilitzes i atribueix-ne l’autoria quan correspongui.

Des d’un projecte de prova, instal·la la carpeta local. Substitueix la ruta de l’exemple per la teva. Si la CLI et proposa publicar, rebutja-ho durant la prova: instal·lar localment i compartir a Internet són decisions diferents.

npx skillscat add ./revisio-catala
  • Prova un text correcte: l’skill no hauria d’inventar-hi errors.
  • Prova variables i ordres: han de quedar intactes.
  • Prova una petició fora d’abast: l’agent ha d’explicar el límit.
  • Revisa els canvis amb una persona i anota l’agent i la versió amb què has fet la prova.

3. Tria com vols compartir-lo

Si el paquet ja és en un repositori públic de GitHub, pots proposar el repositori a SkillsCat. Cal iniciar sessió. Substitueix https://github.com/owner/repo per l’URL real del repositori i comprova abans que tens dret a compartir tots els fitxers. La tramesa inicia el procés d’indexació; no promet una aparició immediata ni una aprovació editorial.

Si vols publicar un paquet local propi, consulta publish --help i revisa la vista prèvia abans de confirmar. La CLI mostra l’slug i la visibilitat; no pressuposis que serà públic. L’slug no es pot canviar després de publicar. No utilitzis --yes si vols conservar la confirmació interactiva.

npx skillscat login
npx skillscat whoami

# Opció A: proposar un repositori públic
npx skillscat submit https://github.com/owner/repo

# Opció B: publicar un paquet propi, després de revisar-lo
npx skillscat publish --help
npx skillscat publish ./revisio-catala

4. Fes fàcil la revisió i la reutilització

Al README, indica que les instruccions són en català, explica els requisits i afegeix exemples sense dades reals. Si ofereixes altres llengües, identifica cada versió i com s’ha de triar; no prometis que l’agent detectarà automàticament qualsevol variant del paquet.

Quan tinguis una fitxa publicada, comparteix el seu slug exacte i l’ordre d’instal·lació corresponent. Convida a comunicar problemes amb exemples reproduïbles. Compartir un skill en català és una contribució pràctica; no implica cap afiliació, reconeixement oficial ni garantia de seguretat.

npx skillscat add owner/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.