Non trattare l'hub o una companion come lo strumento di lavoro.

L'hub elenca i pack. Una pagina companion è Setup: copia o scarica. Nessuna disegna un wireframe, esegue un audit o fa screenshot dei breakpoint. Per quei lavori, apri lo strumento corrispondente nel browser o lascia che la skill installata giri nell'agente.

Non installare una volta e scaricare la stessa skill come secondo flusso.

Esegui npx skills@latest add iruhdam1/skills oppure scarica un pack dalla companion — non entrambi per la stessa skill. Due copie divergono; l'agente può caricare quella vecchia.

Non scrivere descrizioni in prima persona o vaghe.

Claude e altri host scoprono le skill dal campo description. Prima persona (“Ti aiuto…”) o ambito vuoto significa che l'agente non sceglie mai il file. Scrivi cosa fa e quando usarla, in terza persona. Le note di authoring di Anthropic coprono la stessa regola.

Non riempire SKILL.md di tutto.

Tieni il body come procedura. Metti le note lunghe un livello più in basso in un file di riferimento gemello così gli host le caricano solo se serve. Un muro di testo brucia contesto e nasconde il trigger.

Non copiare .agents/skills dello shop né modificare Analog.

La cartella .agents/skills di questo shop (COSS, Phosphor e altri helper dell'agente) non è il pack pubblico. Non copiarla. Non modificare Analog. Il set pubblico è il pack GitHub elencato nell'hub.

Non inseguire un listing mancante su skills.sh.

skills.sh è un elenco pubblico più telemetria di installazione. Un badge mancante non è un push GitHub fallito. Usa GitHub o la companion dello shop se un pack non è ancora elencato. Vedi skills.sh vs GitHub.