@neurocode-ai/web 1.18.8

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

@@ -0,0 +1,291 @@
+---
+title: Server
+description: Nutze den opencode-Server ueber HTTP.
+---
+
+import config from "../../../../config.mjs"
+export const typesUrl = `${config.github}/blob/dev/packages/sdk/js/src/gen/types.gen.ts`
+
+Der Befehl `opencode serve` startet einen headless HTTP-Server.
+Er stellt einen OpenAPI-Endpunkt bereit, den ein opencode-Client nutzen kann.
+
+---
+
+### Nutzung
+
+```bash
+opencode serve [--port <number>] [--hostname <string>] [--cors <origin>]
+```
+
+#### Optionen
+
+| Flag            | Description                         | Default          |
+| --------------- | ----------------------------------- | ---------------- |
+| `--port`        | Port to listen on                   | `4096`           |
+| `--hostname`    | Hostname to listen on               | `127.0.0.1`      |
+| `--mdns`        | Enable mDNS discovery               | `false`          |
+| `--mdns-domain` | Custom domain name for mDNS service | `opencode.local` |
+| `--cors`        | Additional browser origins to allow | `[]`             |
+
+`--cors` kann mehrfach angegeben werden:
+
+```bash
+opencode serve --cors http://localhost:5173 --cors https://app.example.com
+```
+
+---
+
+### Authentifizierung
+
+Setze `OPENCODE_SERVER_PASSWORD`, um den Server mit HTTP Basic Auth zu schuetzen.
+Der Benutzername ist standardmaessig `opencode`, kann aber mit `OPENCODE_SERVER_USERNAME` ueberschrieben werden. Das gilt fuer `opencode serve` und `opencode web`.
+
+```bash
+OPENCODE_SERVER_PASSWORD=your-password opencode serve
+```
+
+---
+
+### Funktionsweise
+
+Wenn du `opencode` startest, werden TUI und Server gestartet.
+Die TUI ist dabei der Client, der mit dem Server spricht; dessen OpenAPI-3.1-Endpunkt dient auch zur Generierung des [SDK](/docs/sdk).
+
+:::tip
+Nutze den opencode-Server, um opencode programmatisch anzusteuern.
+:::
+
+Diese Architektur erlaubt mehrere Clients und programmatische Nutzung.
+
+Mit `opencode serve` startest du einen eigenstaendigen Server.
+Laeuft bereits eine TUI, startet `opencode serve` trotzdem eine neue Serverinstanz.
+
+---
+
+#### Mit bestehendem Server verbinden
+
+Beim TUI-Start werden Port und Hostname zufaellig gewaehlt.
+Alternativ gibst du `--hostname` und `--port` als [Flags](/docs/cli) vor und verbindest dich dann gezielt damit.
+
+Der Endpunkt [`/tui`](#tui) kann die TUI ueber den Server steuern, etwa zum Vorbelegen oder Abschicken von Prompts.
+Dieses Muster nutzen auch die OpenCode-[IDE](/docs/ide)-Plugins.
+
+---
+
+## Spec
+
+Der Server veroeffentlicht eine OpenAPI-3.1-Spezifikation unter:
+
+```
+http://<hostname>:<port>/doc
+```
+
+Zum Beispiel `http://localhost:4096/doc`.
+Nutze die Spec zum Generieren von Clients, zum Pruefen von Request/Response-Typen oder in einem Swagger-Explorer.
+
+---
+
+## APIs
+
+Der opencode-Server stellt folgende APIs bereit.
+
+---
+
+### Global
+
+| Method | Path             | Description                         | Response                             |
+| ------ | ---------------- | ----------------------------------- | ------------------------------------ |
+| `GET`  | `/global/health` | Ruft Server-Status und Version ab   | `{ healthy: true, version: string }` |
+| `GET`  | `/global/event`  | Ruft globale Events ab (SSE-Stream) | Event stream                         |
+
+---
+
+### Project
+
+| Method | Path               | Description                  | Response                                      |
+| ------ | ------------------ | ---------------------------- | --------------------------------------------- |
+| `GET`  | `/project`         | Listet alle Projekte         | <a href={typesUrl}><code>Project[]</code></a> |
+| `GET`  | `/project/current` | Ruft das aktuelle Projekt ab | <a href={typesUrl}><code>Project</code></a>   |
+
+---
+
+### Path & VCS
+
+| Method | Path    | Description                                 | Response                                    |
+| ------ | ------- | ------------------------------------------- | ------------------------------------------- |
+| `GET`  | `/path` | Ruft den aktuellen Pfad ab                  | <a href={typesUrl}><code>Path</code></a>    |
+| `GET`  | `/vcs`  | Ruft VCS-Infos fuer das aktuelle Projekt ab | <a href={typesUrl}><code>VcsInfo</code></a> |
+
+---
+
+### Instanz
+
+| Method | Path                | Description                  | Response  |
+| ------ | ------------------- | ---------------------------- | --------- |
+| `POST` | `/instance/dispose` | Beendet die aktuelle Instanz | `boolean` |
+
+---
+
+### Konfiguration
+
+| Method  | Path                | Description                          | Response                                                                                 |
+| ------- | ------------------- | ------------------------------------ | ---------------------------------------------------------------------------------------- |
+| `GET`   | `/config`           | Ruft Konfigurationsinfos ab          | <a href={typesUrl}><code>Config</code></a>                                               |
+| `PATCH` | `/config`           | Aktualisiert Konfiguration           | <a href={typesUrl}><code>Config</code></a>                                               |
+| `GET`   | `/config/providers` | Listet Provider und Standard-Modelle | `{ providers: `<a href={typesUrl}>Provider[]</a>`, default: { [key: string]: string } }` |
+
+---
+
+### Anbieter
+
+| Method | Path                             | Description                                     | Response                                                                            |
+| ------ | -------------------------------- | ----------------------------------------------- | ----------------------------------------------------------------------------------- |
+| `GET`  | `/provider`                      | Listet alle Provider                            | `{ all: `<a href={typesUrl}>Provider[]</a>`, default: {...}, connected: string[] }` |
+| `GET`  | `/provider/auth`                 | Ruft Authentifizierungsmethoden der Provider ab | `{ [providerID: string]: `<a href={typesUrl}>ProviderAuthMethod[]</a>` }`           |
+| `POST` | `/provider/{id}/oauth/authorize` | Autorisiert einen Provider per OAuth            | <a href={typesUrl}><code>ProviderAuthAuthorization</code></a>                       |
+| `POST` | `/provider/{id}/oauth/callback`  | Behandelt OAuth-Callback fuer einen Provider    | `boolean`                                                                           |
+
+---
+
+### Sitzungen
+
+| Method   | Path                                     | Description                                         | Notes                                                                              |
+| -------- | ---------------------------------------- | --------------------------------------------------- | ---------------------------------------------------------------------------------- |
+| `GET`    | `/session`                               | Listet alle Sitzungen                               | Gibt <a href={typesUrl}><code>Session[]</code></a> zurueck                         |
+| `POST`   | `/session`                               | Erstellt eine neue Sitzung                          | body: `{ parentID?, title? }`, returns <a href={typesUrl}><code>Session</code></a> |
+| `GET`    | `/session/status`                        | Ruft Status aller Sitzungen ab                      | Gibt `{ [sessionID: string]: `<a href={typesUrl}>SessionStatus</a>` }` zurueck     |
+| `GET`    | `/session/:id`                           | Ruft Sitzungsdetails ab                             | Gibt <a href={typesUrl}><code>Session</code></a> zurueck                           |
+| `DELETE` | `/session/:id`                           | Loescht eine Sitzung und alle Daten                 | Gibt `boolean` zurueck                                                             |
+| `PATCH`  | `/session/:id`                           | Aktualisiert Sitzungseigenschaften                  | body: `{ title? }`, returns <a href={typesUrl}><code>Session</code></a>            |
+| `GET`    | `/session/:id/children`                  | Ruft Kind-Sitzungen einer Sitzung ab                | Gibt <a href={typesUrl}><code>Session[]</code></a> zurueck                         |
+| `GET`    | `/session/:id/todo`                      | Ruft die Todo-Liste einer Sitzung ab                | Gibt <a href={typesUrl}><code>Todo[]</code></a> zurueck                            |
+| `POST`   | `/session/:id/init`                      | Analysiert App und erstellt `AGENTS.md`             | body: `{ messageID, providerID, modelID }`, returns `boolean`                      |
+| `POST`   | `/session/:id/fork`                      | Forkt eine bestehende Sitzung an einer Nachricht    | body: `{ messageID? }`, returns <a href={typesUrl}><code>Session</code></a>        |
+| `POST`   | `/session/:id/abort`                     | Bricht eine laufende Sitzung ab                     | Gibt `boolean` zurueck                                                             |
+| `POST`   | `/session/:id/share`                     | Teilt eine Sitzung                                  | Gibt <a href={typesUrl}><code>Session</code></a> zurueck                           |
+| `DELETE` | `/session/:id/share`                     | Hebt Teilen einer Sitzung auf                       | Gibt <a href={typesUrl}><code>Session</code></a> zurueck                           |
+| `GET`    | `/session/:id/diff`                      | Ruft den Diff fuer diese Sitzung ab                 | query: `messageID?`, returns <a href={typesUrl}><code>FileDiff[]</code></a>        |
+| `POST`   | `/session/:id/summarize`                 | Fasst die Sitzung zusammen                          | body: `{ providerID, modelID }`, returns `boolean`                                 |
+| `POST`   | `/session/:id/revert`                    | Setzt eine Nachricht zurueck                        | body: `{ messageID, partID? }`, returns `boolean`                                  |
+| `POST`   | `/session/:id/unrevert`                  | Stellt alle zurueckgesetzten Nachrichten wieder her | Gibt `boolean` zurueck                                                             |
+| `POST`   | `/session/:id/permissions/:permissionID` | Antwortet auf eine Berechtigungsanfrage             | body: `{ response, remember? }`, returns `boolean`                                 |
+
+---
+
+### Nachrichten
+
+| Method | Path                              | Description                                   | Notes                                                                                                                                                                 |
+| ------ | --------------------------------- | --------------------------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
+| `GET`  | `/session/:id/message`            | Listet Nachrichten in einer Sitzung           | query: `limit?`, returns `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}[]`                                                        |
+| `POST` | `/session/:id/message`            | Sendet eine Nachricht und wartet auf Antwort  | 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` | Ruft Nachrichtendetails ab                    | Returns `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}`                                                                           |
+| `POST` | `/session/:id/prompt_async`       | Sendet eine Nachricht asynchron (ohne Warten) | body: same as `/session/:id/message`, returns `204 No Content`                                                                                                        |
+| `POST` | `/session/:id/command`            | Fuehrt einen Slash-Befehl aus                 | body: `{ messageID?, agent?, model?, command, arguments }`, returns `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}`               |
+| `POST` | `/session/:id/shell`              | Fuehrt einen Shell-Befehl aus                 | body: `{ agent, model?, command }`, returns `{ info: `<a href={typesUrl}>Message</a>`, parts: `<a href={typesUrl}>Part[]</a>`}`                                       |
+
+---
+
+### Befehle
+
+| Method | Path       | Description         | Response                                      |
+| ------ | ---------- | ------------------- | --------------------------------------------- |
+| `GET`  | `/command` | Listet alle Befehle | <a href={typesUrl}><code>Command[]</code></a> |
+
+---
+
+### Dateien
+
+| Method | Path                     | Description                                 | Response                                                                                    |
+| ------ | ------------------------ | ------------------------------------------- | ------------------------------------------------------------------------------------------- |
+| `GET`  | `/find?pattern=<pat>`    | Sucht Text in Dateien                       | Array of match objects with `path`, `lines`, `line_number`, `absolute_offset`, `submatches` |
+| `GET`  | `/find/file?query=<q>`   | Findet Dateien und Verzeichnisse nach Namen | `string[]` (paths)                                                                          |
+| `GET`  | `/find/symbol?query=<q>` | Findet Workspace-Symbole                    | <a href={typesUrl}><code>Symbol[]</code></a>                                                |
+| `GET`  | `/file?path=<path>`      | Listet Dateien und Verzeichnisse            | <a href={typesUrl}><code>FileNode[]</code></a>                                              |
+| `GET`  | `/file/content?path=<p>` | Liest eine Datei                            | <a href={typesUrl}><code>FileContent</code></a>                                             |
+| `GET`  | `/file/status`           | Ruft Status fuer getrackte Dateien ab       | <a href={typesUrl}><code>File[]</code></a>                                                  |
+
+#### `/find/file` Abfrageparameter
+
+- `query` (erforderlich) — Suchbegriff (Fuzzy-Suche)
+- `type` (optional) — Ergebnisse auf `"file"` oder `"directory"` beschränken
+- `directory` (optional) — Projektstammverzeichnis für die Suche überschreiben
+- `limit` (optional) — Maximale Ergebnisse (1–200)
+- `dirs` (optional) — Legacy-Flag (`"false"` gibt nur Dateien zurück)
+
+---
+
+### Werkzeuge (Experimentell)
+
+| Method | Path                                        | Description                                   | Response                                     |
+| ------ | ------------------------------------------- | --------------------------------------------- | -------------------------------------------- |
+| `GET`  | `/experimental/tool/ids`                    | Listet alle Tool-IDs                          | <a href={typesUrl}><code>ToolIDs</code></a>  |
+| `GET`  | `/experimental/tool?provider=<p>&model=<m>` | Listet Tools mit JSON-Schemas fuer ein Modell | <a href={typesUrl}><code>ToolList</code></a> |
+
+---
+
+### LSP, Formatierer & MCP
+
+| Method | Path         | Description                      | Response                                                 |
+| ------ | ------------ | -------------------------------- | -------------------------------------------------------- |
+| `GET`  | `/lsp`       | Ruft LSP-Server-Status ab        | <a href={typesUrl}><code>LSPStatus[]</code></a>          |
+| `GET`  | `/formatter` | Ruft Formatter-Status ab         | <a href={typesUrl}><code>FormatterStatus[]</code></a>    |
+| `GET`  | `/mcp`       | Ruft MCP-Server-Status ab        | `{ [name: string]: `<a href={typesUrl}>MCPStatus</a>` }` |
+| `POST` | `/mcp`       | Fuegt MCP-Server dynamisch hinzu | body: `{ name, config }`, returns MCP status object      |
+
+---
+
+### Agenten
+
+| Method | Path     | Description                      | Response                                    |
+| ------ | -------- | -------------------------------- | ------------------------------------------- |
+| `GET`  | `/agent` | Listet alle verfuegbaren Agenten | <a href={typesUrl}><code>Agent[]</code></a> |
+
+---
+
+### Logging
+
+| Method | Path   | Description                                                       | Response  |
+| ------ | ------ | ----------------------------------------------------------------- | --------- |
+| `POST` | `/log` | Schreibt Log-Eintrag. Body: `{ service, level, message, extra? }` | `boolean` |
+
+---
+
+### TUI
+
+| Method | Path                    | Description                                     | Response               |
+| ------ | ----------------------- | ----------------------------------------------- | ---------------------- |
+| `POST` | `/tui/append-prompt`    | Haengt Text an den Prompt an                    | `boolean`              |
+| `POST` | `/tui/open-help`        | Oeffnet den Hilfedialog                         | `boolean`              |
+| `POST` | `/tui/open-sessions`    | Oeffnet die Session-Auswahl                     | `boolean`              |
+| `POST` | `/tui/open-themes`      | Oeffnet die Theme-Auswahl                       | `boolean`              |
+| `POST` | `/tui/open-models`      | Oeffnet die Modell-Auswahl                      | `boolean`              |
+| `POST` | `/tui/submit-prompt`    | Sendet den aktuellen Prompt ab                  | `boolean`              |
+| `POST` | `/tui/clear-prompt`     | Leert den Prompt                                | `boolean`              |
+| `POST` | `/tui/execute-command`  | Fuehrt einen Befehl aus (`{ command }`)         | `boolean`              |
+| `POST` | `/tui/show-toast`       | Zeigt Toast (`{ title?, message, variant }`)    | `boolean`              |
+| `GET`  | `/tui/control/next`     | Wartet auf die naechste Kontrollanfrage         | Control request object |
+| `POST` | `/tui/control/response` | Antwortet auf eine Kontrollanfrage (`{ body }`) | `boolean`              |
+
+---
+
+### Authentifizierung
+
+| Method | Path        | Description                                                              | Response  |
+| ------ | ----------- | ------------------------------------------------------------------------ | --------- |
+| `PUT`  | `/auth/:id` | Setzt Authentifizierungsdaten. Body muss dem Provider-Schema entsprechen | `boolean` |
+
+---
+
+### Events
+
+| Method | Path     | Description                                                                     | Response                  |
+| ------ | -------- | ------------------------------------------------------------------------------- | ------------------------- |
+| `GET`  | `/event` | Server-Sent Events Stream. Erstes Event ist `server.connected`, dann Bus-Events | Server-sent events stream |
+
+---
+
+### Dokumentation
+
+| Method | Path   | Description               | Response                    |
+| ------ | ------ | ------------------------- | --------------------------- |
+| `GET`  | `/doc` | OpenAPI 3.1 Spezifikation | HTML page with OpenAPI spec |

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

@@ -0,0 +1,130 @@
+---
+title: Teilen
+description: Teile OpenCode-Unterhaltungen per oeffentlichem Link.
+---
+
+Mit der Share-Funktion erstellst du oeffentliche Links zu OpenCode-Unterhaltungen.
+So kannst du einfacher mit dem Team zusammenarbeiten oder Hilfe einholen.
+
+:::note
+Geteilte Unterhaltungen sind fuer alle mit dem Link oeffentlich zugaenglich.
+:::
+
+---
+
+## Funktionsweise
+
+Wenn du eine Unterhaltung teilst, macht OpenCode Folgendes:
+
+1. Erstellt eine eindeutige oeffentliche URL fuer deine Sitzung
+2. Synchronisiert den Verlauf auf unsere Server
+3. Stellt die Unterhaltung unter `opncd.ai/s/<share-id>` bereit
+
+---
+
+## Teilen
+
+OpenCode hat drei Modi, die das Teilen steuern:
+
+---
+
+### Manuell (Standard)
+
+Standardmaessig nutzt OpenCode den manuellen Modus.
+Sitzungen werden nicht automatisch geteilt, du kannst sie aber mit `/share` veroeffentlichen:
+
+```
+/share
+```
+
+Dabei wird eine eindeutige URL erzeugt und in die Zwischenablage kopiert.
+
+Um den manuellen Modus explizit in der [Konfiguration](/docs/config) zu setzen:
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "manual"
+}
+```
+
+---
+
+### Auto-Share
+
+Du kannst automatisches Teilen fuer neue Unterhaltungen aktivieren, indem du in der [Konfiguration](/docs/config) `share` auf `"auto"` setzt:
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "auto"
+}
+```
+
+Mit aktiviertem Auto-Share wird jede neue Unterhaltung automatisch geteilt und ein Link erstellt.
+
+---
+
+### Deaktiviert
+
+Du kannst Teilen komplett deaktivieren, indem du in der [Konfiguration](/docs/config) `share` auf `"disabled"` setzt:
+
+```json title="opencode.json"
+{
+  "$schema": "https://opencode.ai/config.json",
+  "share": "disabled"
+}
+```
+
+Wenn das fuer ein Projekt teamweit gelten soll, lege es in der Projekt-`opencode.json` fest und committe die Datei.
+
+---
+
+## Teilen aufheben
+
+Um das Teilen zu beenden und den oeffentlichen Zugriff zu entfernen:
+
+```
+/unshare
+```
+
+Dadurch wird der Share-Link entfernt und die zugehoerigen Daten werden geloescht.
+
+---
+
+## Datenschutz
+
+Beim Teilen solltest du ein paar Punkte beachten.
+
+---
+
+### Datenaufbewahrung
+
+Geteilte Unterhaltungen bleiben veroeffentlicht, bis du sie explizit aufhebst.
+Das umfasst:
+
+- Vollstaendigen Unterhaltungsverlauf
+- Alle Nachrichten und Antworten
+- Sitzungsmetadaten
+
+---
+
+### Empfehlungen
+
+- Teile nur Unterhaltungen ohne sensible Informationen.
+- Pruefe Inhalte vor dem Teilen.
+- Hebe das Teilen wieder auf, wenn die Zusammenarbeit beendet ist.
+- Teile keine proprietaeren Codes oder vertraulichen Daten.
+- Deaktiviere Teilen komplett bei sensiblen Projekten.
+
+---
+
+## Für Unternehmen
+
+In Enterprise-Umgebungen kann die Share-Funktion:
+
+- **Deaktiviert** werden, um Compliance-Vorgaben einzuhalten
+- Auf **SSO-authentifizierte** Nutzer eingeschraenkt werden
+- **Self-hosted** auf eigener Infrastruktur betrieben werden
+
+[Mehr dazu](/docs/enterprise), wie du opencode in deiner Organisation einsetzt.

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

@@ -0,0 +1,222 @@
+---
+title: Agenten-Skills
+description: "Definiere wiederverwendbares Verhalten ueber SKILL.md"
+---
+
+Agent Skills erlauben OpenCode, wiederverwendbare Anweisungen aus deinem Repo oder Home-Verzeichnis zu finden.
+Sie werden bei Bedarf ueber das native `skill`-Tool geladen, wenn ein Agent sie wirklich braucht.
+
+---
+
+## Dateien platzieren
+
+Erstelle pro Skill-Namen einen Ordner und lege dort eine `SKILL.md` ab.
+OpenCode sucht in folgenden Pfaden:
+
+- Project config: `.opencode/skills/<name>/SKILL.md`
+- Global config: `~/.config/opencode/skills/<name>/SKILL.md`
+- Project Claude-compatible: `.claude/skills/<name>/SKILL.md`
+- Global Claude-compatible: `~/.claude/skills/<name>/SKILL.md`
+- Project agent-compatible: `.agents/skills/<name>/SKILL.md`
+- Global agent-compatible: `~/.agents/skills/<name>/SKILL.md`
+
+---
+
+## Discovery verstehen
+
+Bei projektlokalen Pfaden laeuft OpenCode vom aktuellen Verzeichnis nach oben bis zum Git-Worktree.
+Dabei werden passende `skills/*/SKILL.md` in `.opencode/` sowie passende Dateien unter `.claude/skills/*/SKILL.md` und `.agents/skills/*/SKILL.md` geladen.
+
+Globale Definitionen kommen zusaetzlich aus `~/.config/opencode/skills/*/SKILL.md`, `~/.claude/skills/*/SKILL.md` und `~/.agents/skills/*/SKILL.md`.
+
+---
+
+## Frontmatter schreiben
+
+Jede `SKILL.md` muss mit YAML-Frontmatter beginnen.
+Nur diese Felder werden ausgewertet:
+
+- `name` (erforderlich)
+- `description` (erforderlich)
+- `license` (optional)
+- `compatibility` (optional)
+- `metadata` (optional, String-zu-String-Map)
+
+Unbekannte Frontmatter-Felder werden ignoriert.
+
+---
+
+## Namen validieren
+
+`name` muss:
+
+- 1-64 Zeichen lang sein
+- nur Kleinbuchstaben und Ziffern mit einzelnen Bindestrichen enthalten
+- nicht mit `-` beginnen oder enden
+- kein `--` enthalten
+- zum Verzeichnisnamen passen, in dem `SKILL.md` liegt
+
+Entsprechender Regex:
+
+```text
+^[a-z0-9]+(-[a-z0-9]+)*$
+```
+
+---
+
+## Längenregeln beachten
+
+`description` muss 1-1024 Zeichen lang sein.
+Formuliere sie so konkret, dass Agenten den Skill eindeutig auswaehlen koennen.
+
+---
+
+## Beispiel verwenden
+
+Erstelle `.opencode/skills/git-release/SKILL.md` zum Beispiel so:
+
+```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.
+```
+
+---
+
+## Tool-Beschreibung erkennen
+
+OpenCode listet verfuegbare Skills in der Beschreibung des `skill`-Tools.
+Jeder Eintrag enthaelt Namen und Beschreibung:
+
+```xml
+<available_skills>
+  <skill>
+    <name>git-release</name>
+    <description>Create consistent releases and changelogs</description>
+  </skill>
+</available_skills>
+```
+
+Der Agent laedt einen Skill per Tool-Aufruf:
+
+```
+skill({ name: "git-release" })
+```
+
+---
+
+## Berechtigungen konfigurieren
+
+Steuere in `opencode.json` per Muster, auf welche Skills Agenten zugreifen duerfen:
+
+```json
+{
+  "permission": {
+    "skill": {
+      "*": "allow",
+      "pr-review": "allow",
+      "internal-*": "deny",
+      "experimental-*": "ask"
+    }
+  }
+}
+```
+
+| Berechtigung | Verhalten                                |
+| ------------ | ---------------------------------------- |
+| `allow`      | Skill wird sofort geladen                |
+| `deny`       | Skill ist fuer Agenten versteckt         |
+| `ask`        | Vor dem Laden wird nach Freigabe gefragt |
+
+Muster unterstuetzen Wildcards: `internal-*` passt z. B. auf `internal-docs` oder `internal-tools`.
+
+---
+
+## Pro Agent überschreiben
+
+Du kannst einzelnen Agenten andere Berechtigungen als die globalen Defaults geben.
+
+**Fuer benutzerdefinierte Agenten** (im Frontmatter):
+
+```yaml
+---
+permission:
+  skill:
+    "documents-*": "allow"
+---
+```
+
+**Fuer eingebaute Agenten** (in `opencode.json`):
+
+```json
+{
+  "agent": {
+    "plan": {
+      "permission": {
+        "skill": {
+          "internal-*": "allow"
+        }
+      }
+    }
+  }
+}
+```
+
+---
+
+## Skill-Tool deaktivieren
+
+Deaktiviere Skills komplett fuer Agenten, die sie nicht nutzen sollen:
+
+**Fuer benutzerdefinierte Agenten**:
+
+```yaml
+---
+tools:
+  skill: false
+---
+```
+
+**Fuer eingebaute Agenten**:
+
+```json
+{
+  "agent": {
+    "plan": {
+      "tools": {
+        "skill": false
+      }
+    }
+  }
+}
+```
+
+Wenn deaktiviert, wird der Abschnitt `<available_skills>` komplett weggelassen.
+
+---
+
+## Fehlerbehebung beim Laden
+
+Wenn ein Skill nicht auftaucht:
+
+1. Pruefe, ob `SKILL.md` exakt in Grossbuchstaben geschrieben ist
+2. Pruefe, ob Frontmatter `name` und `description` enthaelt
+3. Stelle sicher, dass Skill-Namen ueber alle Orte hinweg eindeutig sind
+4. Pruefe Berechtigungen - Skills mit `deny` sind fuer Agenten unsichtbar