@neurocode-ai/web 1.18.8

package/src/content/docs/it/server.mdx

@@ -0,0 +1,284 @@
+---
+title: Server
+description: Interagisci con il server opencode via HTTP.
+---
+
+import config from "../../../../config.mjs"
+export const typesUrl = `${config.github}/blob/dev/packages/sdk/js/src/gen/types.gen.ts`
+
+Il comando `opencode serve` avvia un server HTTP headless che espone un endpoint OpenAPI utilizzabile da un client opencode.
+
+---
+
+### Utilizzo
+
+```bash
+opencode serve [--port <number>] [--hostname <string>] [--cors <origin>]
+```
+
+#### Opzioni
+
+| Flag            | Descrizione                             | Predefinito      |
+| --------------- | --------------------------------------- | ---------------- |
+| `--port`        | Porta su cui ascoltare                  | `4096`           |
+| `--hostname`    | Hostname su cui ascoltare               | `127.0.0.1`      |
+| `--mdns`        | Abilita la scoperta mDNS                | `false`          |
+| `--mdns-domain` | Nome di dominio personalizzato mDNS     | `opencode.local` |
+| `--cors`        | Origin browser aggiuntive da permettere | `[]`             |
+
+`--cors` puo essere passato piu volte:
+
+```bash
+opencode serve --cors http://localhost:5173 --cors https://app.example.com
+```
+
+---
+
+### Autenticazione
+
+Imposta `OPENCODE_SERVER_PASSWORD` per proteggere il server con HTTP basic auth. Lo username predefinito e `opencode`, oppure imposta `OPENCODE_SERVER_USERNAME` per sovrascriverlo. Questo vale sia per `opencode serve` sia per `opencode web`.
+
+```bash
+OPENCODE_SERVER_PASSWORD=your-password opencode serve
+```
+
+---
+
+### Come funziona
+
+Quando esegui `opencode` avvia una TUI e un server. La TUI e il client che parla col server. Il server espone un endpoint con specifica OpenAPI 3.1. Questo endpoint viene anche usato per generare un [SDK](/docs/sdk).
+
+:::tip
+Usa il server opencode per interagire con opencode in modo programmatico.
+:::
+
+Questa architettura permette a opencode di supportare piu client e di essere usato in modo programmatico.
+
+Puoi eseguire `opencode serve` per avviare un server standalone. Se la TUI di opencode e gia in esecuzione, `opencode serve` avviera un nuovo server.
+
+---
+
+#### Connettersi a un server esistente
+
+Quando avvii la TUI assegna casualmente porta e hostname. In alternativa puoi passare i [flag](/docs/cli) `--hostname` e `--port` e poi usare questi valori per connetterti al suo server.
+
+L'endpoint [`/tui`](#tui) puo essere usato per pilotare la TUI tramite il server. Per esempio, puoi precompilare o eseguire un prompt. Questa configurazione e usata dai plugin [IDE](/docs/ide) di OpenCode.
+
+---
+
+## Specifica
+
+Il server pubblica una specifica OpenAPI 3.1 visualizzabile su:
+
+```
+http://<hostname>:<port>/doc
+```
+
+Per esempio, `http://localhost:4096/doc`. Usa la spec per generare client o ispezionare i tipi di request/response, oppure visualizzala in uno Swagger explorer.
+
+---
+
+## API
+
+Il server opencode espone le seguenti API.
+
+---
+
+### Globale
+
+| Metodo | Path             | Descrizione                 | Response                             |
+| ------ | ---------------- | --------------------------- | ------------------------------------ |
+| `GET`  | `/global/health` | Stato di salute e versione  | `{ healthy: true, version: string }` |
+| `GET`  | `/global/event`  | Eventi globali (stream SSE) | Event stream                         |
+
+---
+
+### Progetto
+
+| Metodo | Path               | Descrizione             | Response                                      |
+| ------ | ------------------ | ----------------------- | --------------------------------------------- |
+| `GET`  | `/project`         | Elenca tutti i progetti | <a href={typesUrl}><code>Project[]</code></a> |
+| `GET`  | `/project/current` | Progetto corrente       | <a href={typesUrl}><code>Project</code></a>   |
+
+---
+
+### Percorso e VCS
+
+| Metodo | Path    | Descrizione                       | Response                                    |
+| ------ | ------- | --------------------------------- | ------------------------------------------- |
+| `GET`  | `/path` | Percorso corrente                 | <a href={typesUrl}><code>Path</code></a>    |
+| `GET`  | `/vcs`  | Info VCS per il progetto corrente | <a href={typesUrl}><code>VcsInfo</code></a> |
+
+---
+
+### Istanza
+
+| Metodo | Path                | Descrizione                 | Response  |
+| ------ | ------------------- | --------------------------- | --------- |
+| `POST` | `/instance/dispose` | Rilascia l'istanza corrente | `boolean` |
+
+---
+
+### Configurazione
+
+| Metodo  | Path                | Descrizione                       | Response                                                                                 |
+| ------- | ------------------- | --------------------------------- | ---------------------------------------------------------------------------------------- |
+| `GET`   | `/config`           | Info sulla config                 | <a href={typesUrl}><code>Config</code></a>                                               |
+| `PATCH` | `/config`           | Aggiorna la config                | <a href={typesUrl}><code>Config</code></a>                                               |
+| `GET`   | `/config/providers` | Elenca provider e modelli default | `{ providers: `<a href={typesUrl}>Provider[]</a>`, default: { [key: string]: string } }` |
+
+---
+
+### Fornitori
+
+| Metodo | Path                             | Descrizione                     | Response                                                                            |
+| ------ | -------------------------------- | ------------------------------- | ----------------------------------------------------------------------------------- |
+| `GET`  | `/provider`                      | Elenca tutti i provider         | `{ all: `<a href={typesUrl}>Provider[]</a>`, default: {...}, connected: string[] }` |
+| `GET`  | `/provider/auth`                 | Metodi auth dei provider        | `{ [providerID: string]: `<a href={typesUrl}>ProviderAuthMethod[]</a>` }`           |
+| `POST` | `/provider/{id}/oauth/authorize` | Autorizza un provider via OAuth | <a href={typesUrl}><code>ProviderAuthAuthorization</code></a>                       |
+| `POST` | `/provider/{id}/oauth/callback`  | Gestisce callback OAuth         | `boolean`                                                                           |
+
+---
+
+### Sessioni
+
+| Metodo   | Path                                     | Descrizione                           | Note                                                                               |
+| -------- | ---------------------------------------- | ------------------------------------- | ---------------------------------------------------------------------------------- |
+| `GET`    | `/session`                               | Elenca tutte le sessioni              | Returns <a href={typesUrl}><code>Session[]</code></a>                              |
+| `POST`   | `/session`                               | Crea una nuova sessione               | body: `{ parentID?, title? }`, returns <a href={typesUrl}><code>Session</code></a> |
+| `GET`    | `/session/status`                        | Stato di tutte le sessioni            | Returns `{ [sessionID: string]: `<a href={typesUrl}>SessionStatus</a>` }`          |
+| `GET`    | `/session/:id`                           | Dettagli di sessione                  | Returns <a href={typesUrl}><code>Session</code></a>                                |
+| `DELETE` | `/session/:id`                           | Elimina una sessione e i suoi dati    | Returns `boolean`                                                                  |
+| `PATCH`  | `/session/:id`                           | Aggiorna proprieta sessione           | body: `{ title? }`, returns <a href={typesUrl}><code>Session</code></a>            |
+| `GET`    | `/session/:id/children`                  | Sessioni figlie                       | Returns <a href={typesUrl}><code>Session[]</code></a>                              |
+| `GET`    | `/session/:id/todo`                      | Todo list della sessione              | Returns <a href={typesUrl}><code>Todo[]</code></a>                                 |
+| `POST`   | `/session/:id/init`                      | Analizza app e crea `AGENTS.md`       | body: `{ messageID, providerID, modelID }`, returns `boolean`                      |
+| `POST`   | `/session/:id/fork`                      | Fork di sessione su un messaggio      | body: `{ messageID? }`, returns <a href={typesUrl}><code>Session</code></a>        |
+| `POST`   | `/session/:id/abort`                     | Interrompe una sessione in esecuzione | Returns `boolean`                                                                  |
+| `POST`   | `/session/:id/share`                     | Condivide una sessione                | Returns <a href={typesUrl}><code>Session</code></a>                                |
+| `DELETE` | `/session/:id/share`                     | Annulla condivisione                  | Returns <a href={typesUrl}><code>Session</code></a>                                |
+| `GET`    | `/session/:id/diff`                      | Diff della sessione                   | query: `messageID?`, returns <a href={typesUrl}><code>FileDiff[]</code></a>        |
+| `POST`   | `/session/:id/summarize`                 | Riassume la sessione                  | body: `{ providerID, modelID }`, returns `boolean`                                 |
+| `POST`   | `/session/:id/revert`                    | Ripristina un messaggio               | body: `{ messageID, partID? }`, returns `boolean`                                  |
+| `POST`   | `/session/:id/unrevert`                  | Ripristina tutti i messaggi revertiti | Returns `boolean`                                                                  |
+| `POST`   | `/session/:id/permissions/:permissionID` | Risponde a una richiesta permessi     | body: `{ response, remember? }`, returns `boolean`                                 |
+
+---
+
+### Messaggi
+
+| Metodo | Path                              | Descrizione                              | Note                                                                                                                                                                  |
+| ------ | --------------------------------- | ---------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `GET`  | `/session/:id/message`            | Elenca messaggi in una sessione          | query: `limit?`, returns `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}[]`                                                        |
+| `POST` | `/session/:id/message`            | Invia un messaggio e attende risposta    | body: `{ messageID?, model?, agent?, noReply?, system?, tools?, parts }`, returns `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}` |
+| `GET`  | `/session/:id/message/:messageID` | Dettagli messaggio                       | Returns `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}`                                                                           |
+| `POST` | `/session/:id/prompt_async`       | Invia un messaggio in async (senza wait) | body: same as `/session/:id/message`, returns `204 No Content`                                                                                                        |
+| `POST` | `/session/:id/command`            | Esegue un comando slash                  | body: `{ messageID?, agent?, model?, command, arguments }`, returns `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}`               |
+| `POST` | `/session/:id/shell`              | Esegue un comando shell                  | body: `{ agent, model?, command }`, returns `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}`                                       |
+
+---
+
+### Comandi
+
+| Metodo | Path       | Descrizione      | Response                                      |
+| ------ | ---------- | ---------------- | --------------------------------------------- |
+| `GET`  | `/command` | Elenca i comandi | <a href={typesUrl}><code>Command[]</code></a> |
+
+---
+
+### File
+
+| Metodo | Path                     | Descrizione                     | Response                                                                                    |
+| ------ | ------------------------ | ------------------------------- | ------------------------------------------------------------------------------------------- |
+| `GET`  | `/find?pattern=<pat>`    | Cerca testo nei file            | Array of match objects with `path`, `lines`, `line_number`, `absolute_offset`, `submatches` |
+| `GET`  | `/find/file?query=<q>`   | Trova file e directory per nome | `string[]` (paths)                                                                          |
+| `GET`  | `/find/symbol?query=<q>` | Trova simboli workspace         | <a href={typesUrl}><code>Symbol[]</code></a>                                                |
+| `GET`  | `/file?path=<path>`      | Elenca file e directory         | <a href={typesUrl}><code>FileNode[]</code></a>                                              |
+| `GET`  | `/file/content?path=<p>` | Legge un file                   | <a href={typesUrl}><code>FileContent</code></a>                                             |
+| `GET`  | `/file/status`           | Stato dei file tracciati        | <a href={typesUrl}><code>File[]</code></a>                                                  |
+
+#### `/find/file` query parameters
+
+- `query` (required) — stringa di ricerca (fuzzy match)
+- `type` (optional) — limita i risultati a `"file"` o `"directory"`
+- `directory` (optional) — sovrascrive la root del progetto per la ricerca
+- `limit` (optional) — massimo risultati (1–200)
+- `dirs` (optional) — flag legacy (`"false"` restituisce solo file)
+
+---
+
+### Strumenti (sperimentale)
+
+| Metodo | Path                                        | Descrizione                                | Response                                     |
+| ------ | ------------------------------------------- | ------------------------------------------ | -------------------------------------------- |
+| `GET`  | `/experimental/tool/ids`                    | Elenca tutti i tool ID                     | <a href={typesUrl}><code>ToolIDs</code></a>  |
+| `GET`  | `/experimental/tool?provider=<p>&model=<m>` | Elenca tool con JSON schema per un modello | <a href={typesUrl}><code>ToolList</code></a> |
+
+---
+
+### LSP, formatter e MCP
+
+| Metodo | Path         | Descrizione                 | Response                                                 |
+| ------ | ------------ | --------------------------- | -------------------------------------------------------- |
+| `GET`  | `/lsp`       | Stato server LSP            | <a href={typesUrl}><code>LSPStatus[]</code></a>          |
+| `GET`  | `/formatter` | Stato formatter             | <a href={typesUrl}><code>FormatterStatus[]</code></a>    |
+| `GET`  | `/mcp`       | Stato server MCP            | `{ [name: string]: `<a href={typesUrl}>MCPStatus</a>` }` |
+| `POST` | `/mcp`       | Aggiunge server MCP runtime | body: `{ name, config }`, returns MCP status object      |
+
+---
+
+### Agenti
+
+| Metodo | Path     | Descrizione             | Response                                    |
+| ------ | -------- | ----------------------- | ------------------------------------------- |
+| `GET`  | `/agent` | Elenca tutti gli agenti | <a href={typesUrl}><code>Agent[]</code></a> |
+
+---
+
+### Log
+
+| Metodo | Path   | Descrizione                                                         | Response  |
+| ------ | ------ | ------------------------------------------------------------------- | --------- |
+| `POST` | `/log` | Scrive una voce di log. Body: `{ service, level, message, extra? }` | `boolean` |
+
+---
+
+### TUI
+
+| Metodo | Path                    | Descrizione                                        | Response               |
+| ------ | ----------------------- | -------------------------------------------------- | ---------------------- |
+| `POST` | `/tui/append-prompt`    | Aggiunge testo al prompt                           | `boolean`              |
+| `POST` | `/tui/open-help`        | Apre il dialog help                                | `boolean`              |
+| `POST` | `/tui/open-sessions`    | Apre il selettore sessioni                         | `boolean`              |
+| `POST` | `/tui/open-themes`      | Apre il selettore temi                             | `boolean`              |
+| `POST` | `/tui/open-models`      | Apre il selettore modelli                          | `boolean`              |
+| `POST` | `/tui/submit-prompt`    | Invia il prompt corrente                           | `boolean`              |
+| `POST` | `/tui/clear-prompt`     | Pulisce il prompt                                  | `boolean`              |
+| `POST` | `/tui/execute-command`  | Esegue un comando (`{ command }`)                  | `boolean`              |
+| `POST` | `/tui/show-toast`       | Mostra toast (`{ title?, message, variant }`)      | `boolean`              |
+| `GET`  | `/tui/control/next`     | Attende la prossima richiesta di controllo         | Control request object |
+| `POST` | `/tui/control/response` | Risponde a una richiesta di controllo (`{ body }`) | `boolean`              |
+
+---
+
+### Autenticazione
+
+| Metodo | Path        | Descrizione                                                          | Response  |
+| ------ | ----------- | -------------------------------------------------------------------- | --------- |
+| `PUT`  | `/auth/:id` | Imposta credenziali auth. Il body deve rispettare lo schema provider | `boolean` |
+
+---
+
+### Eventi
+
+| Metodo | Path     | Descrizione                                                 | Response                  |
+| ------ | -------- | ----------------------------------------------------------- | ------------------------- |
+| `GET`  | `/event` | Stream SSE. Primo evento `server.connected`, poi eventi bus | Server-sent events stream |
+
+---
+
+### Documentazione
+
+| Metodo | Path   | Descrizione           | Response                     |
+| ------ | ------ | --------------------- | ---------------------------- |
+| `GET`  | `/doc` | Specifica OpenAPI 3.1 | Pagina HTML con spec OpenAPI |

package/src/content/docs/it/share.mdx

@@ -0,0 +1,127 @@
+---
+title: Condivisione
+description: Condividi le tue conversazioni OpenCode.
+---
+
+La funzione di condivisione di OpenCode ti permette di creare link pubblici alle tue conversazioni, cosi puoi collaborare con i colleghi o chiedere aiuto ad altre persone.
+
+:::note
+Le conversazioni condivise sono accessibili pubblicamente a chiunque abbia il link.
+:::
+
+---
+
+## Come funziona
+
+Quando condividi una conversazione, OpenCode:
+
+1. Crea un URL pubblico univoco per la sessione
+2. Sincronizza la cronologia della conversazione sui nostri server
+3. Rende la conversazione accessibile tramite il link condivisibile: `opncd.ai/s/<share-id>`
+
+---
+
+## Condivisione
+
+OpenCode supporta tre modalita di condivisione che controllano come vengono condivise le conversazioni:
+
+---
+
+### Manuale (predefinito)
+
+Per impostazione predefinita, OpenCode usa la condivisione manuale. Le sessioni non vengono condivise automaticamente, ma puoi condividerle manualmente con il comando `/share`:
+
+```
+/share
+```
+
+Questo genera un URL univoco che viene copiato negli appunti.
+
+Per impostare esplicitamente la modalita manuale nel tuo [file di config](/docs/config):
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "manual"
+}
+```
+
+---
+
+### Automatico
+
+Puoi abilitare la condivisione automatica per tutte le nuove conversazioni impostando l'opzione `share` su `"auto"` nel tuo [file di config](/docs/config):
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "auto"
+}
+```
+
+Con la condivisione automatica attiva, ogni nuova conversazione verra condivisa automaticamente e verra generato un link.
+
+---
+
+### Disabilitato
+
+Puoi disabilitare completamente la condivisione impostando l'opzione `share` su `"disabled"` nel tuo [file di config](/docs/config):
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "disabled"
+}
+```
+
+Per applicarlo al tuo team in un progetto specifico, aggiungilo a `opencode.json` nel progetto e versionalo su Git.
+
+---
+
+## Annullare la condivisione
+
+Per smettere di condividere una conversazione e rimuoverla dall'accesso pubblico:
+
+```
+/unshare
+```
+
+Questo rimuove il link di condivisione ed elimina i dati associati alla conversazione.
+
+---
+
+## Privacy
+
+Ci sono alcune cose da tenere a mente quando condividi una conversazione.
+
+---
+
+### Conservazione dati
+
+Le conversazioni condivise restano accessibili finche non le annulli esplicitamente. Questo include:
+
+- La cronologia completa della conversazione
+- Tutti i messaggi e le risposte
+- I metadati della sessione
+
+---
+
+### Raccomandazioni
+
+- Condividi solo conversazioni che non contengono informazioni sensibili.
+- Rivedi il contenuto della conversazione prima di condividerla.
+- Annulla la condivisione quando la collaborazione e conclusa.
+- Evita di condividere conversazioni con codice proprietario o dati riservati.
+- Per progetti sensibili, disabilita completamente la condivisione.
+
+---
+
+## Per le aziende
+
+Per deploy enterprise, la condivisione puo essere:
+
+- **Disabilitata** completamente per requisiti di conformita e sicurezza
+- **Limitata** ai soli utenti autenticati tramite SSO
+- **Self-hosted** sulla tua infrastruttura
+
+[Scopri di piu](/docs/enterprise) su come usare opencode nella tua organizzazione.

package/src/content/docs/it/skills.mdx

@@ -0,0 +1,222 @@
+---
+title: "Competenze dell'agente"
+description: "Definisci comportamenti riutilizzabili tramite definizioni in SKILL.md"
+---
+
+Le skill degli agenti permettono a OpenCode di individuare istruzioni riutilizzabili dal tuo repo o dalla home directory.
+Le skill vengono caricate on-demand tramite lo strumento nativo `skill`: gli agenti vedono le skill disponibili e possono caricarne il contenuto completo quando serve.
+
+---
+
+## Posizione dei file
+
+Crea una cartella per ogni nome di skill e metti un `SKILL.md` al suo interno.
+OpenCode cerca in queste posizioni:
+
+- Config di progetto: `.opencode/skills/<name>/SKILL.md`
+- Config globale: `~/.config/opencode/skills/<name>/SKILL.md`
+- Progetto compatibile con Claude: `.claude/skills/<name>/SKILL.md`
+- Globale compatibile con Claude: `~/.claude/skills/<name>/SKILL.md`
+- Progetto compatibile con agent: `.agents/skills/<name>/SKILL.md`
+- Globale compatibile con agent: `~/.agents/skills/<name>/SKILL.md`
+
+---
+
+## Discovery
+
+Per i percorsi locali al progetto, OpenCode risale dalla directory di lavoro corrente finche' non raggiunge il worktree git.
+Carica qualsiasi `skills/*/SKILL.md` corrispondente in `.opencode/` e qualsiasi `.claude/skills/*/SKILL.md` o `.agents/skills/*/SKILL.md` corrispondente lungo il percorso.
+
+Le definizioni globali vengono caricate anche da `~/.config/opencode/skills/*/SKILL.md`, `~/.claude/skills/*/SKILL.md` e `~/.agents/skills/*/SKILL.md`.
+
+---
+
+## Frontmatter
+
+Ogni `SKILL.md` deve iniziare con frontmatter YAML.
+Sono riconosciuti solo questi campi:
+
+- `name` (obbligatorio)
+- `description` (obbligatorio)
+- `license` (opzionale)
+- `compatibility` (opzionale)
+- `metadata` (opzionale, mappa stringa-a-stringa)
+
+I campi di frontmatter sconosciuti vengono ignorati.
+
+---
+
+## Validazione nomi
+
+`name` deve:
+
+- Essere lungo 1-64 caratteri
+- Essere alfanumerico minuscolo con separatori `-` singoli
+- Non iniziare o finire con `-`
+- Non contenere `--` consecutivi
+- Corrispondere al nome della directory che contiene `SKILL.md`
+
+Regex equivalente:
+
+```text
+^[a-z0-9]+(-[a-z0-9]+)*$
+```
+
+---
+
+## Regole di lunghezza
+
+`description` deve essere lunga 1-1024 caratteri.
+Tieni la descrizione abbastanza specifica da permettere all'agente di scegliere correttamente.
+
+---
+
+## Esempio
+
+Crea `.opencode/skills/git-release/SKILL.md` cosi':
+
+```markdown
+---
+name: git-release
+description: Create consistent releases and changelogs
+license: MIT
+compatibility: opencode
+metadata:
+  audience: maintainers
+  workflow: github
+---
+
+## What I do
+
+- Draft release notes from merged PRs
+- Propose a version bump
+- Provide a copy-pasteable `gh release create` command
+
+## When to use me
+
+Use this when you are preparing a tagged release.
+Ask clarifying questions if the target versioning scheme is unclear.
+```
+
+---
+
+## Descrizione strumento
+
+OpenCode elenca le skill disponibili nella descrizione dello strumento `skill`.
+Ogni voce include il nome della skill e la descrizione:
+
+```xml
+<available_skills>
+  <skill>
+    <name>git-release</name>
+    <description>Create consistent releases and changelogs</description>
+  </skill>
+</available_skills>
+```
+
+L'agente carica una skill chiamando lo strumento:
+
+```
+skill({ name: "git-release" })
+```
+
+---
+
+## Permessi
+
+Controlla a quali skill gli agenti possono accedere usando permessi basati su pattern in `opencode.json`:
+
+```json
+{
+  "permission": {
+    "skill": {
+      "*": "allow",
+      "pr-review": "allow",
+      "internal-*": "deny",
+      "experimental-*": "ask"
+    }
+  }
+}
+```
+
+| Permesso | Comportamento                                |
+| -------- | -------------------------------------------- |
+| `allow`  | La skill viene caricata immediatamente       |
+| `deny`   | Skill nascosta all'agente, accesso negato    |
+| `ask`    | L'utente viene invitato ad approvare il load |
+
+I pattern supportano wildcard: `internal-*` corrisponde a `internal-docs`, `internal-tools`, ecc.
+
+---
+
+## Sovrascrittura per agente
+
+Dai ad agenti specifici permessi diversi dai default globali.
+
+**Per agenti personalizzati** (nel frontmatter dell'agente):
+
+```yaml
+---
+permission:
+  skill:
+    "documents-*": "allow"
+---
+```
+
+**Per agenti integrati** (in `opencode.json`):
+
+```json
+{
+  "agent": {
+    "plan": {
+      "permission": {
+        "skill": {
+          "internal-*": "allow"
+        }
+      }
+    }
+  }
+}
+```
+
+---
+
+## Disabilitare skill
+
+Disabilita completamente le skill per agenti che non dovrebbero usarle:
+
+**Per agenti personalizzati**:
+
+```yaml
+---
+tools:
+  skill: false
+---
+```
+
+**Per agenti integrati**:
+
+```json
+{
+  "agent": {
+    "plan": {
+      "tools": {
+        "skill": false
+      }
+    }
+  }
+}
+```
+
+Quando e' disabilitato, la sezione `<available_skills>` viene omessa completamente.
+
+---
+
+## Risoluzione problemi
+
+Se una skill non compare:
+
+1. Verifica che `SKILL.md` sia scritto in maiuscolo
+2. Controlla che il frontmatter includa `name` e `description`
+3. Assicurati che i nomi delle skill siano unici in tutte le posizioni
+4. Controlla i permessi: le skill con `deny` vengono nascoste agli agenti