Agenti
Come mestiere installa le Agent Skills per Claude Code, Kiro, Codex, Cursor e altri agenti, come usare le copie e come farlo configurare al tuo agente.
Un agente, o harness, è uno strumento di coding che legge le skill. mestiere salva ogni skill installata una sola volta in .agents/skills/, la cartella condivisa che Codex, Gemini CLI, Cursor, GitHub Copilot e altri agenti leggono direttamente. Gli agenti con una cartella propria, come Claude Code e Kiro, ricevono dei link a quella cartella.
Agenti supportati
| Agente | ID | Cartella delle skill |
|---|---|---|
| Tutti (archivio canonico) | agents (sempre attivo) |
.agents/skills/ |
| Claude Code | claude |
.claude/skills/ |
| Kiro | kiro |
.kiro/skills/ |
Codex, Gemini CLI, Cursor, GitHub Copilot e qualsiasi altro harness che legge .agents/skills/ vedono le skill installate senza impostazioni aggiuntive, quindi non serve una voce in agents.
Cambia gli agenti di un progetto
Modifica agents in skills.yaml, poi sincronizza:
agents:
- claude
- kiro
mestiere sync
sync aggiunge i link per i nuovi agenti e li rimuove per gli agenti che hai tolto. Per sceglierli durante la configurazione, usa mestiere init --agents claude,kiro.
Symlink o copie
Di default ogni cartella di un agente riceve un symlink relativo a .agents/skills/<name>. Se uno strumento non segue i symlink, dai alle cartelle degli agenti delle copie reali:
link: copy
Oppure sceglilo durante la configurazione con mestiere init --link copy.
Insegna al tuo agente a usare mestiere
Il repository di mestiere è anche un registry. Contiene due skill che insegnano agli agenti di coding a usare mestiere nel modo corretto, anche per configurarlo in un nuovo repository:
| Skill | Per |
|---|---|
mestiere/project |
Repository che installano skill: aggiungere, aggiornare, sincronizzare, fare eject, fare commit, risolvere gli errori di doctor |
mestiere/registry |
Repository di registry: scaffolding, scrivere SKILL.md, condividere file tramite _shared/, risolvere gli errori di lint, CI |
Si installano a livello globale, per ogni progetto sulla tua macchina. L'installazione con Homebrew lo fa già; altrimenti esegui una volta:
mestiere add -g mestiere
I colleghi il cui agente non le ha eseguono lo stesso comando. Poi chiedi al tuo agente, da qualsiasi repository:
Configura mestiere per questo repo con il nostro registry git@github.com:polarity-dev/skills.git
L'agente esegue mestiere init, ti mostra cosa offre il registry, installa le skill adatte al codebase e fa il commit di skills.yaml. Le richieste successive funzionano allo stesso modo:
- "Qualcuna delle nostre skill è obsoleta? Aggiornale e riassumi cosa è cambiato."
- "Voglio modificare frontend-forms per questo repo, tienila come nostra e fanne il commit."
- "Perché mestiere doctor fallisce?"
Leggere questa documentazione da un agente
Ogni pagina di questo sito ha una versione Markdown allo stesso URL più index.md, ad esempio /docs/commands/index.md. llms.txt le elenca tutte, e llms-full.txt contiene tutta la documentazione in un solo file.