Gestore di Agent Skills per Claude Code, Kiro, Codex, Cursor e altri
Le skill degli agenti del tuo team, in ogni repository.
Tieni le skill in un solo registry git. Ogni progetto installa quelle che gli servono, fissate a una versione esatta.
brew install --cask polarity-dev/tap/mestiereCome funziona
-
Tieni le skill in un registry
Un registry è un normale repository git di Agent Skills, raggruppate in namespace come
frontendobackend. Revisiona le skill come qualsiasi altro codice. -
Installale in ogni progetto
mestiere add frontendcopia le skill in.agents/skills/e blocca ognuna su un commit del registry inskills.yaml. -
Ogni agente le vede
Codex, Gemini CLI, Cursor e Copilot leggono
.agents/skills/direttamente; Claude Code e Kiro ricevono link nelle proprie cartelle. Colleghi e CI eseguonomestiere synce ricevono gli stessi file.
Avvio rapido
Installa le skill in un progetto
mestiere init --agents claude,kiro
mestiere registry add polarity git@github.com:polarity-dev/skills.git
mestiere add frontend backend/db-migrations
git add skills.yaml .gitignore
git commit -m "Add team skills"Un collega che clona il repository esegue mestiere sync.
Pubblica le skill in un registry
mkdir skills && cd skills && git init
mestiere registry init --name polarity
mestiere registry new-namespace frontend --description "Frontend practices"
mestiere registry new-skill frontend/forms --description "Build accessible forms"
mestiere registry lintFai il push, e qualsiasi progetto può aggiungerlo.
Perché mestiere
Il mestiere è il saper fare che una bottega passa da una persona all'altra. mestiere fa lo stesso per gli agenti di programmazione.
Una sola fonte di verità
Le skill vivono in un registry git, pubblico o privato, revisionato come qualsiasi altro codice.
Organizzate per namespace
Installa un intero namespace o una singola skill. Le nuove skill di un namespace installato arrivano al prossimo aggiornamento.
Riproducibili
Ogni installazione è bloccata su un commit del registry e un hash del contenuto. Colleghi e CI ricevono skill identiche byte per byte.
Tutti gli agenti insieme
I file vivono una sola volta in
.agents/skills/, che Codex, Gemini CLI, Cursor e altri leggono direttamente. Claude Code e Kiro ricevono symlink verso di essa.Non ti intralcia
Le skill installate sono ignorate da git per impostazione predefinita. Le tue skill restano accanto a loro intatte, e fare il commit di una skill richiede un solo comando.
Sicuro per costruzione
mestiere sostituisce una cartella solo quando può dimostrare che è una copia non modificata di una skill pubblicata. Vedi il modello di sicurezza.
Nessun lock-in
I registry sono normali repository git. Le skill installate sono normali cartelle che seguono la specifica Agent Skills.
Il tuo git, la tua autenticazione
mestiere usa il
gitdi sistema, quindi chiavi SSH, credential helper egh authfunzionano senza altro.
Oppure fallo configurare al tuo agente
L'installazione con Homebrew dà anche a Claude Code e Kiro le skill di mestiere, per ogni progetto sulla tua macchina. Poi chiedi al tuo agente, da qualsiasi repository:
Configura mestiere per questo repo con il nostro registry git@github.com:polarity-dev/skills.gitL'agente esegue mestiere init, ti mostra cosa offre il registry, installa le skill adatte al codice e fa il commit di skills.yaml. I prompt successivi funzionano allo stesso modo: "Qualcuna delle nostre skill è obsoleta? Aggiornale e riassumi cosa è cambiato".
Hai installato in un altro modo? Esegui una volta mestiere add -g mestiere. Gli agenti che leggono il web possono partire da llms.txt.
Domande frequenti
Cos'è mestiere?
mestiere è uno strumento da riga di comando che installa Agent Skills da repository git nei tuoi progetti. Funziona come un package manager per skill: dichiari cosa vuoi in skills.yaml, mestiere lo risolve in commit esatti del registry, e chiunque esegua mestiere sync riceve gli stessi file.
Cosa sono le Agent Skills?
Una Agent Skill è una cartella con un file SKILL.md, più gli script, i riferimenti e gli asset che le servono. Agenti di programmazione come Claude Code, Kiro, Codex e Cursor leggono la descrizione della skill e la caricano quando un'attività corrisponde. Il formato è descritto su agentskills.io.
Quali agenti di programmazione supporta mestiere?
Tutti gli agenti che leggono le Agent Skills. I file installati vivono in .agents/skills/, la cartella condivisa che Codex, Gemini CLI, Cursor, GitHub Copilot e altri leggono direttamente. Claude Code (.claude/skills/) e Kiro (.kiro/skills/) ricevono link verso di essa. Vedi Agenti.
Posso usare un repository di skill privato?
Sì. mestiere usa il git di sistema, quindi un registry funziona ovunque funzioni git clone: chiavi SSH, credential helper e gh auth inclusi. In CI, dai al job credenziali che possano leggere il registry.
Come condivido le skill con tutto il team?
Fai il commit di skills.yaml e .gitignore. Colleghi e CI eseguono mestiere sync, che installa esattamente le versioni nel lock. In CI, mestiere sync --frozen fallisce se il file non è coerente. Vedi CI.
Devo fare il commit delle skill installate?
No. Le skill installate sono ignorate da git per impostazione predefinita, perché skills.yaml basta per riprodurle. Per fare comunque il commit di una skill, esegui mestiere track <skill>.
mestiere sovrascriverà una skill che ho modificato?
No. Prima di sostituire o eliminare una cartella, mestiere controlla che il suo contenuto corrisponda a una versione pubblicata nel registry. Le skill modificate fermano sync; tieni le tue modifiche con mestiere eject <skill>. Vedi il modello di sicurezza.
Il mio agente può configurare mestiere per me?
Sì. mestiere include le sue skill, e l'installazione con Homebrew le dà a Claude Code e Kiro per ogni progetto. Chiedi "Configura mestiere per questo repo con il nostro registry init, propone le skill e fa il commit di skills.yaml. Vedi Agenti.
Posso installare skill per tutti i progetti sulla mia macchina?
Sì, con -g: mestiere add -g -r polarity frontend installa in ~/.agents/skills/, con i link per i tuoi agenti, e il manifest in ~/.config/mestiere/skills.yaml. Preferisci le installazioni di progetto per le skill su cui il team fa affidamento, perché solo uno skills.yaml nel commit dà a colleghi e CI le stesse versioni. Vedi Skill globali.
Come aggiorno le skill?
mestiere outdated elenca le skill il cui contenuto è cambiato nel registry. mestiere update le porta tutte all'ultima versione, oppure solo quelle che indichi. Vedi Come funzionano gli aggiornamenti.
mestiere funziona su Windows?
Non ancora. Sono supportati macOS e Linux su amd64 e arm64; il supporto per Windows è nella roadmap.
Dai a ogni repository le stesse skill
Sfoglia i comandi Installa mestiere
mestiere funziona nel terminale del tuo Mac o della tua macchina Linux. Inviati il link e configuralo in due minuti.