Riferimento comandi
Ogni comando di mestiere con argomenti, flag ed esempi: init, registry, add, remove, sync, update, outdated, status, track, eject, doctor e cache.
Esegui mestiere <command> --help per avere le stesse informazioni nel terminale.
Flag globali
| Flag | Effetto |
|---|---|
-C, --dir <dir> |
Esegue come se partisse da <dir> |
-q, --quiet |
Stampa solo warning ed errori |
-g, --global |
Agisce sulle skill installate per tutti i progetti, nella tua home directory. Vedi Skill globali. |
--version |
Stampa la versione di mestiere |
-h, --help |
Aiuto per qualsiasi comando |
Target
I comandi che accettano skill supportano diverse forme:
| Forma | Significa |
|---|---|
frontend |
Il namespace frontend |
frontend/forms |
La skill forms di frontend |
frontend-forms |
La stessa skill, per nome installato |
polarity:frontend |
frontend dal registry polarity |
Codice di uscita
I comandi escono con un codice diverso da zero per qualsiasi riga error:. Le righe warning: e hint: non fanno fallire il comando.
Configurazione del progetto
mestiere init
Crea skills.yaml e la regola di .gitignore nel progetto corrente.
mestiere init --agents claude,kiro
| Flag | Effetto |
|---|---|
--agents <list> |
Agenti separati da virgola: claude, kiro. Se lo ometti in un terminale, te lo chiede. |
--link <mode> |
Come gli agenti ricevono le skill: symlink (default) o copy |
Registry
mestiere registry add
Aggiunge un registry al progetto.
mestiere registry add <name> <url> [--ref <branch|tag|commit>]
mestiere registry add polarity git@github.com:polarity-dev/skills.git --ref main
Per default --ref è il branch di default del registry.
mestiere registry remove
Disinstalla le skill del registry e lo toglie da skills.yaml.
mestiere registry remove <name> [--force]
--force cancella anche le skill con modifiche locali.
mestiere registry list
Elenca i registry del progetto.
mestiere registry show
Elenca i namespace e le skill offerti da un registry, con descrizioni e stato di installazione.
mestiere registry show [name]
Installare e rimuovere
mestiere add
Installa namespace o skill.
mestiere add <namespace | namespace/skill>... [-r <registry>] [--force]
mestiere add frontend
mestiere add backend/db-migrations -r polarity
| Flag | Effetto |
|---|---|
-r, --registry <name> |
Registry da cui installare; obbligatorio quando ne sono configurati diversi |
--force |
Sovrascrive le cartelle esistenti con lo stesso nome |
Senza argomenti, add apre un selettore interattivo.
mestiere remove
Disinstalla namespace o skill.
mestiere remove <namespace | namespace/skill>... [--force]
Rimuovere una sola skill di un namespace installato la aggiunge invece a exclude. Le skill modificate vengono tenute e segnalate come skill locali, a meno che tu non passi --force.
Sincronizzare e aggiornare
mestiere sync
Allinea le cartelle delle skill al lock in skills.yaml. Eseguilo dopo un clone, un pull, un cambio di branch o una modifica a mano.
mestiere sync [--frozen] [--force] [--dry-run]
| Flag | Effetto |
|---|---|
--frozen |
Fallisce se install e lock non coincidono, invece di risolvere di nuovo. Usalo in CI. |
--force |
Sovrascrive le modifiche locali |
--dry-run |
Stampa cosa cambierebbe |
mestiere update
Porta le skill nel lock all'ultima versione del loro ref. Senza target, aggiorna tutto. Aggiornare un namespace prende anche le skill aggiunte e toglie quelle cancellate.
mestiere update [target]... [--force]
mestiere update frontend polarity:backend
mestiere outdated
Mostra le skill il cui contenuto è cambiato nel loro registry. Un commit che non tocca una skill non viene segnalato.
Ispezionare
mestiere status
Mostra le skill installate, i loro link, le skill locali (comprese quelle non committate) e le skill globali da ~/.agents/skills, ~/.claude/skills e ~/.kiro/skills. In una cartella senza skills.yaml elenca le skill già presenti.
mestiere doctor
Controlla il progetto senza cambiare nulla: coerenza del lock, modifiche locali, link, .gitignore e accesso ai registry.
mestiere doctor [--strict] [--offline]
| Flag | Effetto |
|---|---|
--strict |
Fallisce anche sulle skill locali non committate |
--offline |
Salta i controlli di rete |
Errori comuni e come risolverli:
| Messaggio | Soluzione |
|---|---|
has local changes |
Tienile con mestiere eject <name>, o scartale con mestiere sync --force |
install and lock disagree |
Esegui mestiere sync e fai commit di skills.yaml |
already exists and isn't a published version |
Una skill locale ha lo stesso nome: rinominala, o sovrascrivila con --force |
comes from both <a> and <b> |
Aggiungi la skill a exclude in uno dei registry |
isn't reachable |
Un problema di accesso git: controlla le tue credenziali per quell'URL |
is committed but ignored |
git rm -r --cached <path>, oppure mestiere track <name> per continuare a committarla |
Le tue skill
mestiere track
Fa il commit di una skill aggiungendo eccezioni a .gitignore per ogni cartella in cui compare.
mestiere track <skill>...
mestiere untrack
Rimuove le eccezioni a .gitignore di una skill.
mestiere untrack <skill>...
mestiere eject
Tiene una skill installata come tua. I file restano; mestiere smette di gestirli ed esclude la skill dalle installazioni future del suo namespace.
mestiere eject <skill>... [--track]
--track fa anche il commit delle skill espulse. Non si applica con -g.
Skill globali
Con -g, questi comandi agiscono sulle skill di tutti i progetti sulla tua macchina invece che sul repository corrente: add, remove, update, outdated, sync, status, doctor, eject e i sottocomandi di registry.
mestiere add -g mestiere
mestiere registry add -g polarity git@github.com:polarity-dev/skills.git
mestiere add -g -r polarity frontend
mestiere status -g
init, track e untrack non si applicano: niente di globale sta in git. Dove vanno i file e il manifest: Skill globali.
Cache
mestiere cache
Ispeziona o svuota la cache dei registry: un mirror git bare per ogni registry.
mestiere cache dir # stampa la directory della cache
mestiere cache info # mostra la directory e la sua dimensione
mestiere cache clean # cancella tutti i mirror; vengono scaricati di nuovo quando servono
La posizione è configurabile: vedi Configurazione.
Scrivere un registry
mestiere registry init
Crea la struttura di un nuovo repository di registry.
mestiere registry init [dir] [--name <name>] [--description <text>]
Per default --name è il nome della directory.
mestiere registry new-namespace
mestiere registry new-namespace <namespace> [--description <text>] [--owners <list>]
mestiere registry new-skill
Crea una skill con un template di SKILL.md.
mestiere registry new-skill <namespace>/<skill> [--description <text>]
mestiere registry lint
Controlla un registry rispetto alle regole sui nomi e su SKILL.md. Eseguilo nella CI del registry.
mestiere registry lint [dir]
Vedi cosa controlla lint.
Completamento della shell
mestiere completion bash|zsh|fish
Istruzioni di configurazione: Installazione.