@neurocode-ai/web 1.18.8

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

@@ -0,0 +1,287 @@
+---
+title: Serveur
+description: Interagissez avec le serveur opencode via HTTP.
+---
+
+import config from "../../../../config.mjs"
+export const typesUrl = `${config.github}/blob/dev/packages/sdk/js/src/gen/types.gen.ts`
+
+La commande `opencode serve` exécute un serveur HTTP sans tête qui expose un point de terminaison OpenAPI qu'un client opencode peut utiliser.
+
+---
+
+### Usage
+
+```bash
+opencode serve [--port <number>] [--hostname <string>] [--cors <origin>]
+```
+
+#### Options
+
+| Drapeau         | Descriptif                                         | Par défaut       |
+| --------------- | -------------------------------------------------- | ---------------- |
+| `--port`        | Port à écouter sur                                 | `4096`           |
+| `--hostname`    | Nom d'hôte sur lequel écouter                      | `127.0.0.1`      |
+| `--mdns`        | Activer la découverte mDNS                         | `false`          |
+| `--mdns-domain` | Nom de domaine personnalisé pour le service mDNS   | `opencode.local` |
+| `--cors`        | Origines de navigateur supplémentaires à autoriser | `[]`             |
+
+`--cors` peut être transmis plusieurs fois :
+
+```bash
+opencode serve --cors http://localhost:5173 --cors https://app.example.com
+```
+
+---
+
+### Authentification
+
+Définissez `OPENCODE_SERVER_PASSWORD` pour protéger le serveur avec l'authentification de base HTTP. Le nom d'utilisateur est par défaut `opencode`, ou définissez `OPENCODE_SERVER_USERNAME` pour le remplacer. Cela s’applique à la fois à `opencode serve` et à `opencode web`.
+
+```bash
+OPENCODE_SERVER_PASSWORD=your-password opencode serve
+```
+
+---
+
+### Comment ça marche
+
+Lorsque vous exécutez `opencode`, il démarre un TUI et un serveur. Où le TUI est le
+client qui parle au serveur. Le serveur expose une spécification OpenAPI 3.1
+point final. Ce point de terminaison est également utilisé pour générer un [SDK](/docs/sdk).
+
+:::tip
+Utilisez le serveur opencode pour interagir avec opencode par programmation.
+:::
+
+Cette architecture permet à opencode de prendre en charge plusieurs clients et vous permet d'interagir avec opencode par programme.
+
+Vous pouvez exécuter `opencode serve` pour démarrer un serveur autonome. Si vous avez le
+opencode TUI en cours d'exécution, `opencode serve` démarrera un nouveau serveur.
+
+---
+
+#### Connectez-vous à un serveur existant
+
+Lorsque vous démarrez le TUI, il attribue de manière aléatoire un port et un nom d'hôte. Vous pouvez à la place transmettre les `--hostname` et `--port` [flags](/docs/cli). Utilisez-le ensuite pour vous connecter à son serveur.
+
+Le point de terminaison [`/tui`](#tui) peut être utilisé pour piloter le TUI via le serveur. Par exemple, vous pouvez pré-remplir ou exécuter une invite. Cette configuration est utilisée par les plugins OpenCode [IDE](/docs/ide).
+
+---
+
+## Spécification
+
+Le serveur publie une spécification OpenAPI 3.1 qui peut être consultée à l'adresse :
+
+```
+http://<hostname>:<port>/doc
+```
+
+Par exemple, `http://localhost:4096/doc`. Utilisez la spécification pour générer des clients ou inspecter les types de requêtes et de réponses. Ou visualisez-le dans un explorateur Swagger.
+
+---
+
+## APIs
+
+Le serveur opencode expose les API suivantes.
+
+---
+
+### Mondial
+
+| Méthode | Chemin           | Descriptif                                 | Réponse                              |
+| ------- | ---------------- | ------------------------------------------ | ------------------------------------ |
+| `GET`   | `/global/health` | Obtenir l'état et la version du serveur    | `{ healthy: true, version: string }` |
+| `GET`   | `/global/event`  | Obtenez des événements mondiaux (flux SSE) | Flux d'événements                    |
+
+---
+
+### Projet
+
+| Méthode | Chemin             | Descriptif                 | Réponse                                       |
+| ------- | ------------------ | -------------------------- | --------------------------------------------- |
+| `GET`   | `/project`         | Lister tous les projets    | <a href={typesUrl}><code>Project[]</code></a> |
+| `GET`   | `/project/current` | Obtenez le projet en cours | <a href={typesUrl}><code>Project</code></a>   |
+
+---
+
+### Chemin et VCS
+
+| Méthode | Chemin  | Descriptif                                           | Réponse                                     |
+| ------- | ------- | ---------------------------------------------------- | ------------------------------------------- |
+| `GET`   | `/path` | Obtenir le chemin actuel                             | <a href={typesUrl}><code>Path</code></a>    |
+| `GET`   | `/vcs`  | Obtenir des informations VCS pour le projet en cours | <a href={typesUrl}><code>VcsInfo</code></a> |
+
+---
+
+### Exemple
+
+| Méthode | Chemin              | Descriptif                    | Réponse   |
+| ------- | ------------------- | ----------------------------- | --------- |
+| `POST`  | `/instance/dispose` | Supprimer l'instance actuelle | `boolean` |
+
+---
+
+### Configuration
+
+| Méthode | Chemin              | Descriptif                                   | Réponse                                                                                  |
+| ------- | ------------------- | -------------------------------------------- | ---------------------------------------------------------------------------------------- |
+| `GET`   | `/config`           | Obtenir des informations de configuration    | <a href={typesUrl}><code>Config</code></a>                                               |
+| `PATCH` | `/config`           | Mettre à jour la configuration               | <a href={typesUrl}><code>Config</code></a>                                               |
+| `GET`   | `/config/providers` | Liste des fournisseurs et modèles par défaut | `{ providers: `<a href={typesUrl}>Provider[]</a>`, default: { [key: string]: string } }` |
+
+---
+
+### Fournisseur
+
+| Méthode | Chemin                           | Descriptif                                             | Réponse                                                                             |
+| ------- | -------------------------------- | ------------------------------------------------------ | ----------------------------------------------------------------------------------- |
+| `GET`   | `/provider`                      | Liste de tous les fournisseurs                         | `{ all: `<a href={typesUrl}>Provider[]</a>`, default: {...}, connected: string[] }` |
+| `GET`   | `/provider/auth`                 | Obtenir les méthodes d'authentification du fournisseur | `{ [providerID: string]: `<a href={typesUrl}>ProviderAuthMethod[]</a>` }`           |
+| `POST`  | `/provider/{id}/oauth/authorize` | Autoriser un fournisseur en utilisant OAuth            | <a href={typesUrl}><code>ProviderAuthAuthorization</code></a>                       |
+| `POST`  | `/provider/{id}/oauth/callback`  | Gérer le rappel OAuth pour un fournisseur              | `boolean`                                                                           |
+
+---
+
+### Séances
+
+| Méthode  | Chemin                                   | Descriptif                                            | Remarques                                                                            |
+| -------- | ---------------------------------------- | ----------------------------------------------------- | ------------------------------------------------------------------------------------ |
+| `GET`    | `/session`                               | Liste toutes les sessions                             | Renvoie <a href={typesUrl}><code>Session[]</code></a>                                |
+| `POST`   | `/session`                               | Créer une nouvelle session                            | corps : `{ parentID?, title? }`, renvoie <a href={typesUrl}><code>Session</code></a> |
+| `GET`    | `/session/status`                        | Obtenir l'état de la session pour toutes les sessions | Renvoie `{ [sessionID: string]: `<a href={typesUrl}>SessionStatus</a>` }`            |
+| `GET`    | `/session/:id`                           | Obtenez les détails de la session                     | Renvoie <a href={typesUrl}><code>Session</code></a>                                  |
+| `DELETE` | `/session/:id`                           | Supprimer une session et toutes ses données           | Renvoie `boolean`                                                                    |
+| `PATCH`  | `/session/:id`                           | Mettre à jour les propriétés de la session            | corps : `{ title? }`, renvoie <a href={typesUrl}><code>Session</code></a>            |
+| `GET`    | `/session/:id/children`                  | Obtenir les sessions enfants d'une session            | Renvoie <a href={typesUrl}><code>Session[]</code></a>                                |
+| `GET`    | `/session/:id/todo`                      | Obtenez la liste de tâches pour une session           | Renvoie <a href={typesUrl}><code>Todo[]</code></a>                                   |
+| `POST`   | `/session/:id/init`                      | Analysez l'application et créez `AGENTS.md`           | corps : `{ messageID, providerID, modelID }`, renvoie `boolean`                      |
+| `POST`   | `/session/:id/fork`                      | Forkez une session existante à un message             | corps : `{ messageID? }`, renvoie <a href={typesUrl}><code>Session</code></a>        |
+| `POST`   | `/session/:id/abort`                     | Abandonner une session en cours                       | Renvoie `boolean`                                                                    |
+| `POST`   | `/session/:id/share`                     | Partager une séance                                   | Renvoie <a href={typesUrl}><code>Session</code></a>                                  |
+| `DELETE` | `/session/:id/share`                     | Annuler le partage d'une session                      | Renvoie <a href={typesUrl}><code>Session</code></a>                                  |
+| `GET`    | `/session/:id/diff`                      | Obtenez le diff pour cette session                    | requête : `messageID?`, renvoie <a href={typesUrl}><code>FileDiff[]</code></a>       |
+| `POST`   | `/session/:id/summarize`                 | Résumer la séance                                     | corps : `{ providerID, modelID }`, renvoie `boolean`                                 |
+| `POST`   | `/session/:id/revert`                    | Rétablir un message                                   | corps : `{ messageID, partID? }`, renvoie `boolean`                                  |
+| `POST`   | `/session/:id/unrevert`                  | Restaurer tous les messages annulés                   | Renvoie `boolean`                                                                    |
+| `POST`   | `/session/:id/permissions/:permissionID` | Répondre à une demande d'autorisation                 | corps : `{ response, remember? }`, renvoie `boolean`                                 |
+
+---
+
+### Messages
+
+| Méthode | Chemin                            | Descriptif                                               | Remarques                                                                                                                                                               |
+| ------- | --------------------------------- | -------------------------------------------------------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `GET`   | `/session/:id/message`            | Liste des messages dans une session                      | requête : `limit?`, renvoie `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}[]`                                                       |
+| `POST`  | `/session/:id/message`            | Envoyer un message et attendre une réponse               | corps : `{ messageID?, model?, agent?, noReply?, system?, tools?, parts }`, renvoie `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}` |
+| `GET`   | `/session/:id/message/:messageID` | Obtenir les détails du message                           | Renvoie `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}`                                                                             |
+| `POST`  | `/session/:id/prompt_async`       | Envoyer un message de manière asynchrone (pas d'attente) | body : identique à `/session/:id/message`, renvoie `204 No Content`                                                                                                     |
+| `POST`  | `/session/:id/command`            | Exécuter une commande slash                              | corps : `{ messageID?, agent?, model?, command, arguments }`, renvoie `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}`               |
+| `POST`  | `/session/:id/shell`              | Exécuter une commande shell                              | corps : `{ agent, model?, command }`, renvoie `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}`                                       |
+
+---
+
+### Commandes
+
+| Méthode | Chemin     | Descriptif                 | Réponse                                       |
+| ------- | ---------- | -------------------------- | --------------------------------------------- |
+| `GET`   | `/command` | Liste toutes les commandes | <a href={typesUrl}><code>Command[]</code></a> |
+
+---
+
+### Fichiers
+
+| Méthode | Chemin                   | Descriptif                                         | Réponse                                                                                             |
+| ------- | ------------------------ | -------------------------------------------------- | --------------------------------------------------------------------------------------------------- |
+| `GET`   | `/find?pattern=<pat>`    | Rechercher du texte dans des fichiers              | Tableau d'objets correspondant avec `path`, `lines`, `line_number`, `absolute_offset`, `submatches` |
+| `GET`   | `/find/file?query=<q>`   | Rechercher des fichiers et des répertoires par nom | `string[]` (chemins)                                                                                |
+| `GET`   | `/find/symbol?query=<q>` | Rechercher des symboles d'espace de travail        | <a href={typesUrl}><code>Symbol[]</code></a>                                                        |
+| `GET`   | `/file?path=<path>`      | Liste des fichiers et répertoires                  | <a href={typesUrl}><code>FileNode[]</code></a>                                                      |
+| `GET`   | `/file/content?path=<p>` | Lire un fichier                                    | <a href={typesUrl}><code>FileContent</code></a>                                                     |
+| `GET`   | `/file/status`           | Obtenir le statut des fichiers suivis              | <a href={typesUrl}><code>File[]</code></a>                                                          |
+
+#### Paramètres de requête `/find/file`
+
+- `query` (obligatoire) — chaîne de recherche (correspondance floue)
+- `type` (facultatif) — limiter les résultats à `"file"` ou `"directory"`
+- `directory` (facultatif) — remplace la racine du projet pour la recherche
+- `limit` (facultatif) — résultats maximum (1 à 200)
+- `dirs` (facultatif) — indicateur hérité (`"false"` renvoie uniquement les fichiers)
+
+---
+
+### Outils (expérimentaux)
+
+| Méthode | Chemin                                      | Descriptif                                                  | Réponse                                      |
+| ------- | ------------------------------------------- | ----------------------------------------------------------- | -------------------------------------------- |
+| `GET`   | `/experimental/tool/ids`                    | Répertorier tous les ID d'outils                            | <a href={typesUrl}><code>ToolIDs</code></a>  |
+| `GET`   | `/experimental/tool?provider=<p>&model=<m>` | Répertorier les outils avec des schémas JSON pour un modèle | <a href={typesUrl}><code>ToolList</code></a> |
+
+---
+
+### LSP, formateurs et MCP
+
+| Méthode | Chemin       | Descriptif                           | Réponse                                                  |
+| ------- | ------------ | ------------------------------------ | -------------------------------------------------------- |
+| `GET`   | `/lsp`       | Obtenir l'état du serveur LSP        | <a href={typesUrl}><code>LSPStatus[]</code></a>          |
+| `GET`   | `/formatter` | Obtenir le statut du formateur       | <a href={typesUrl}><code>FormatterStatus[]</code></a>    |
+| `GET`   | `/mcp`       | Obtenir l'état du serveur MCP        | `{ [name: string]: `<a href={typesUrl}>MCPStatus</a>` }` |
+| `POST`  | `/mcp`       | Ajouter dynamiquement le serveur MCP | corps : `{ name, config }`, renvoie l'objet d'état MCP   |
+
+---
+
+### Agents
+
+| Méthode | Chemin   | Descriptif                        | Réponse                                     |
+| ------- | -------- | --------------------------------- | ------------------------------------------- |
+| `GET`   | `/agent` | Liste tous les agents disponibles | <a href={typesUrl}><code>Agent[]</code></a> |
+
+---
+
+### Enregistrement
+
+| Méthode | Chemin | Descriptif                                                                  | Réponse   |
+| ------- | ------ | --------------------------------------------------------------------------- | --------- |
+| `POST`  | `/log` | Écrire une entrée de journal. Corps : `{ service, level, message, extra? }` | `boolean` |
+
+---
+
+### TUI
+
+| Méthode | Chemin                  | Descriptif                                         | Réponse                      |
+| ------- | ----------------------- | -------------------------------------------------- | ---------------------------- |
+| `POST`  | `/tui/append-prompt`    | Ajouter du texte à l'invite                        | `boolean`                    |
+| `POST`  | `/tui/open-help`        | Ouvrir la boîte de dialogue d'aide                 | `boolean`                    |
+| `POST`  | `/tui/open-sessions`    | Ouvrez le sélecteur de session                     | `boolean`                    |
+| `POST`  | `/tui/open-themes`      | Ouvrez le sélecteur de thème                       | `boolean`                    |
+| `POST`  | `/tui/open-models`      | Ouvrez le sélecteur de modèle                      | `boolean`                    |
+| `POST`  | `/tui/submit-prompt`    | Soumettre l'invite actuelle                        | `boolean`                    |
+| `POST`  | `/tui/clear-prompt`     | Effacez l'invite                                   | `boolean`                    |
+| `POST`  | `/tui/execute-command`  | Exécuter une commande (`{ command }`)              | `boolean`                    |
+| `POST`  | `/tui/show-toast`       | Afficher le toast (`{ title?, message, variant }`) | `boolean`                    |
+| `GET`   | `/tui/control/next`     | Attendre la prochaine demande de contrôle          | Objet de demande de contrôle |
+| `POST`  | `/tui/control/response` | Répondre à une demande de contrôle (`{ body }`)    | `boolean`                    |
+
+---
+
+### Authentification
+
+| Méthode | Chemin      | Descriptif                                                                                          | Réponse   |
+| ------- | ----------- | --------------------------------------------------------------------------------------------------- | --------- |
+| `PUT`   | `/auth/:id` | Définissez les informations d'authentification. Le corps doit correspondre au schéma du fournisseur | `boolean` |
+
+---
+
+### Événements
+
+| Méthode | Chemin   | Descriptif                                                                                                        | Réponse                                  |
+| ------- | -------- | ----------------------------------------------------------------------------------------------------------------- | ---------------------------------------- |
+| `GET`   | `/event` | Flux d’événements envoyés par le serveur. Le premier événement est `server.connected`, puis les événements de bus | Flux d'événements envoyés par le serveur |
+
+---
+
+### Documents
+
+| Méthode | Chemin | Descriptif                | Réponse                              |
+| ------- | ------ | ------------------------- | ------------------------------------ |
+| `GET`   | `/doc` | Spécification OpenAPI 3.1 | Page HTML avec spécification OpenAPI |

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

@@ -0,0 +1,128 @@
+---
+title: Partager
+description: Partagez vos conversations OpenCode.
+---
+
+La fonctionnalité de partage de OpenCode vous permet de créer des liens publics vers vos conversations OpenCode, afin que vous puissiez collaborer avec vos coéquipiers ou obtenir de l'aide d'autres personnes.
+
+:::note
+Les conversations partagées sont accessibles publiquement à toute personne disposant du lien.
+:::
+
+---
+
+## Comment ça marche
+
+Lorsque vous partagez une conversation, OpenCode :
+
+1. Crée un URL public unique pour votre session
+2. Synchronise l'historique de vos conversations avec nos serveurs
+3. Rend la conversation accessible via le lien partageable — `opncd.ai/s/<share-id>`
+
+---
+
+## Partage
+
+OpenCode prend en charge trois modes de partage qui contrôlent la manière dont les conversations sont partagées :
+
+---
+
+### Manuel (par défaut)
+
+Par défaut, OpenCode utilise le mode de partage manuel. Les sessions ne sont pas partagées automatiquement, mais vous pouvez les partager manuellement à l'aide de la commande `/share` :
+
+```
+/share
+```
+
+Cela générera un URL unique qui sera copié dans votre presse-papiers.
+
+Pour définir explicitement le mode manuel dans votre [fichier de configuration](/docs/config) :
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "manual"
+}
+```
+
+---
+
+### Partage automatique
+
+Vous pouvez activer le partage automatique pour toutes les nouvelles conversations en définissant l'option `share` sur `"auto"` dans votre [fichier de configuration](/docs/config) :
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "auto"
+}
+```
+
+Avec le partage automatique activé, chaque nouvelle conversation sera automatiquement partagée et un lien sera généré.
+
+---
+
+### Désactivé
+
+Vous pouvez désactiver entièrement le partage en définissant l'option `share` sur `"disabled"` dans votre [fichier de configuration](/docs/config) :
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "disabled"
+}
+```
+
+Pour appliquer cela au sein de votre équipe pour un projet donné, ajoutez-le au `opencode.json` dans votre projet et enregistrez-vous dans Git.
+
+---
+
+## Annuler le partage
+
+Pour arrêter de partager une conversation et la supprimer de l'accès public :
+
+```
+/unshare
+```
+
+Cela supprimera le lien de partage et supprimera les données liées à la conversation.
+
+---
+
+## Confidentialité
+
+Il y a quelques points à garder à l’esprit lorsque vous partagez une conversation.
+
+---
+
+### Conservation des données
+
+Les conversations partagées restent accessibles jusqu'à ce que vous les annuliez explicitement. Ce
+comprend :
+
+- Historique complet des conversations
+- Tous les messages et réponses
+- Métadonnées de session
+
+---
+
+### Recommandations
+
+- Partagez uniquement les conversations qui ne contiennent pas d'informations sensibles.
+- Examinez le contenu de la conversation avant de la partager.
+- Annulez le partage des conversations une fois la collaboration terminée.
+- Évitez de partager des conversations avec du code propriétaire ou des données confidentielles.
+- Pour les projets sensibles, désactivez complètement le partage.
+
+---
+
+## Pour les entreprises
+
+Pour les déploiements en entreprise, la fonctionnalité de partage peut être :
+
+- **Désactivé** entièrement pour des raisons de conformité en matière de sécurité
+- **Réservé** aux utilisateurs authentifiés via SSO uniquement
+- **Auto-hébergé** sur votre propre infrastructure
+
+[En savoir plus](/docs/enterprise) sur l'utilisation de opencode dans votre organisation.

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

@@ -0,0 +1,222 @@
+---
+title: "Compétences des agents"
+description: "Définir un comportement réutilisable via les définitions SKILL.md"
+---
+
+Les compétences d'agent permettent à OpenCode de découvrir des instructions réutilisables à partir de votre dépôt ou de votre répertoire personnel.
+Les compétences sont chargées à la demande via l'outil natif `skill` : les agents voient les compétences disponibles et peuvent charger le contenu complet en cas de besoin.
+
+---
+
+## Placer des fichiers
+
+Créez un dossier par nom de compétence et insérez-y un `SKILL.md`.
+OpenCode recherche ces emplacements :
+
+- Configuration du projet : `.opencode/skills/<name>/SKILL.md`
+- Configuration globale : `~/.config/opencode/skills/<name>/SKILL.md`
+- Compatible Projet Claude : `.claude/skills/<name>/SKILL.md`
+- Compatible Global Claude : `~/.claude/skills/<name>/SKILL.md`
+- Compatible avec l'agent de projet : `.agents/skills/<name>/SKILL.md`
+- Compatible avec les agents globaux : `~/.agents/skills/<name>/SKILL.md`
+
+---
+
+## Comprendre la découverte
+
+Pour les chemins locaux du projet, OpenCode remonte de votre répertoire de travail actuel jusqu'à ce qu'il atteigne l'arbre de travail git.
+Il charge tout `skills/*/SKILL.md` correspondant dans `.opencode/` et tout `.claude/skills/*/SKILL.md` ou `.agents/skills/*/SKILL.md` correspondant en cours de route.
+
+Les définitions globales sont également chargées à partir de `~/.config/opencode/skills/*/SKILL.md`, `~/.claude/skills/*/SKILL.md` et `~/.agents/skills/*/SKILL.md`.
+
+---
+
+## Écrire un texte de présentation
+
+Chaque `SKILL.md` doit commencer par YAML frontmatter.
+Seuls ces champs sont reconnus :
+
+- `name` (obligatoire)
+- `description` (obligatoire)
+- `license` (facultatif)
+- `compatibility` (facultatif)
+- `metadata` (facultatif, mappage chaîne à chaîne)
+
+Les champs de contenu inconnus sont ignorés.
+
+---
+
+## Valider les noms
+
+`name` doit :
+
+- Comprenant entre 1 et 64 caractères
+- Être alphanumérique en minuscules avec des séparateurs à tiret unique
+- Ne commence ni ne termine par `-`
+- Ne contient pas de `--` consécutifs
+- Faites correspondre le nom du répertoire qui contient `SKILL.md`
+
+Expression régulière équivalente :
+
+```text
+^[a-z0-9]+(-[a-z0-9]+)*$
+```
+
+---
+
+## Suivez les règles de longueur
+
+`description` doit comporter entre 1 et 1 024 caractères.
+Gardez-le suffisamment précis pour que l'agent puisse choisir correctement.
+
+---
+
+## Utiliser un exemple
+
+Créez `.opencode/skills/git-release/SKILL.md` comme ceci :
+
+```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.
+```
+
+---
+
+## Reconnaître la description de l'outil
+
+OpenCode répertorie les compétences disponibles dans la description de l'outil `skill`.
+Chaque entrée comprend le nom et la description de la compétence :
+
+```xml
+<available_skills>
+  <skill>
+    <name>git-release</name>
+    <description>Create consistent releases and changelogs</description>
+  </skill>
+</available_skills>
+```
+
+L'agent charge une compétence en appelant l'outil :
+
+```
+skill({ name: "git-release" })
+```
+
+---
+
+## Configurer les autorisations
+
+Contrôlez les compétences auxquelles les agents peuvent accéder à l'aide d'autorisations basées sur des modèles dans `opencode.json` :
+
+```json
+{
+  "permission": {
+    "skill": {
+      "*": "allow",
+      "pr-review": "allow",
+      "internal-*": "deny",
+      "experimental-*": "ask"
+    }
+  }
+}
+```
+
+| Autorisation | Comportement                                                          |
+| ------------ | --------------------------------------------------------------------- |
+| `allow`      | Les compétences se chargent immédiatement                             |
+| `deny`       | Compétence masquée à l'agent, accès refusé                            |
+| `ask`        | L'utilisateur est invité à donner son approbation avant le chargement |
+
+Les modèles prennent en charge les caractères génériques : `internal-*` correspond à `internal-docs`, `internal-tools`, etc.
+
+---
+
+## Remplacement par agent
+
+Accordez à des agents spécifiques des autorisations différentes de celles par défaut globales.
+
+**Pour les agents personnalisés** (dans la rubrique Agent) :
+
+```yaml
+---
+permission:
+  skill:
+    "documents-*": "allow"
+---
+```
+
+**Pour les agents intégrés** (dans `opencode.json`) :
+
+```json
+{
+  "agent": {
+    "plan": {
+      "permission": {
+        "skill": {
+          "internal-*": "allow"
+        }
+      }
+    }
+  }
+}
+```
+
+---
+
+## Désactiver l'outil de compétences
+
+Désactivez complètement les compétences pour les agents qui ne devraient pas les utiliser :
+
+**Pour les agents personnalisés** :
+
+```yaml
+---
+tools:
+  skill: false
+---
+```
+
+**Pour les agents intégrés** :
+
+```json
+{
+  "agent": {
+    "plan": {
+      "tools": {
+        "skill": false
+      }
+    }
+  }
+}
+```
+
+Lorsqu'elle est désactivée, la section `<available_skills>` est entièrement omise.
+
+---
+
+## Dépanner le chargement
+
+Si une compétence n'apparaît pas :
+
+1. Vérifiez que `SKILL.md` est écrit en majuscules
+2. Vérifiez que le frontmatter inclut `name` et `description`
+3. Assurez-vous que les noms des compétences sont uniques sur tous les sites
+4. Vérifiez les autorisations : les compétences avec `deny` sont masquées aux agents