Aggiungere una nuova skill al Skill Hub

Guida operativa per l'agente (e per l'utente). Le skill vivono nel package pi-skill-hub (canonico: git git.enne2.net/enne2/pi-skill-hub).

1. Creare la skill

Crea la directory skills/<nome-kebab-case>/ dentro il package con:
- SKILL.md — frontmatter (name uguale al nome dir, description con trigger "usa quando…" ed esclusioni "non usare per…") + corpo operativo (Outcome, Preconditions, Non-negotiable gates, Workflow, Salvataggio, Verifica/exit criteria, Resource loading)
- references/*.md — dettagli tecnici, catalogo errori, dati di configurazione
- scripts/… — helper deterministici (niente segreti, niente path macchina-specifici: quelli vanno in qmem nei project host-*)
Rispetta i limiti della spec Agent Skills: SKILL.md ≤ ~500 righe, dettagli in references, descrizione ≤ 1024 caratteri.
I contenuti che oggi vivono in qmem NON si duplicano: in qmem restano solo puntatori (project della skill) ed evidenze di esecuzione.

Testa la skill sul task reale (o harness); registra l'esito in qmem (project della skill o skills/<nome>/validazioni).
pi -e <package> per provarla senza installare.

Usa il tool skill_sync (message opzionale): esegue pull --ff-only → git add skills/ → commit → push su origin main. Su errore (conflitto/rete) riporta il messaggio: NON fare rebase/merge automatici; chiedere all'utente.
Le altre macchine ricevono con l'auto-pull all'avvio di sessione, oppure pi update --extensions (o git -C <clone> pull + /skill-sync).

Commit piccoli e descrittivi; tag v<maggiore> per cambiamenti di contratto (macchine che vogliono stabilità installano @<tag>).
Modifiche che cambiano regole operative (es. nuove regole vincolanti) vanno segnalate all'utente prima del push (review umana = promotion gate).