# KI-Assistenten

Damit KI-Assistenten Fragen zu Workist anhand dieser Dokumentation beantworten statt aus dem Gedächtnis, stellt Workist einen Skill bereit. Unabhängig davon steht jede Seite als Markdown zur Verfügung.

## Skill „workist-docs“

Der Skill gibt Claude und anderen KI-Agenten Anweisungen für Fragen zu Workist:

- Er liest zu jeder Frage die passenden Seiten dieser Dokumentation und antwortet mit dem Pfad in der Kanal-Konfiguration, den exakten Bezeichnungen der Einstellungen und einem Link auf die Seite.
- Bevor eine kundenspezifische Anpassung, ein Workaround oder ein Ticket geplant wird, prüft er, ob sich die Anforderung bereits per Konfiguration umsetzen lässt.
- Er antwortet in der Sprache der Frage.

Der Skill enthält keine Inhalte der Dokumentation, sondern ruft sie bei jeder Frage neu ab. Änderungen an der Dokumentation wirken deshalb sofort; neu installieren müssen Sie den Skill nur, wenn sich der Skill selbst ändert.

| Datei | Verwendung |
| --- | --- |
| [workist-docs.skill](/skills/workist-docs.skill) | Claude Desktop, Installation per Doppelklick |
| [workist-docs.zip](/skills/workist-docs.zip) | Upload in Claude im Browser |
| [SKILL.md](/skills/workist-docs/SKILL.md) | Claude Code und andere KI-Agenten |

## Einrichtung

### Claude Desktop

1. Laden Sie [workist-docs.skill](/skills/workist-docs.skill) herunter.
2. Öffnen Sie die Datei per Doppelklick. Sie öffnet sich in Claude Desktop.
3. Bestätigen Sie den Import und prüfen Sie unter **Customize → Skills**, dass der Skill aktiviert ist.
4. Geben Sie docs.workist.com frei, siehe [Netzwerkzugriff](#netzwerkzugriff).

### Claude im Browser

1. Laden Sie [workist-docs.zip](/skills/workist-docs.zip) herunter.
2. Öffnen Sie in Claude **Customize → Skills** und laden Sie die ZIP-Datei hoch.
3. Aktivieren Sie den Skill.
4. Geben Sie docs.workist.com frei, siehe [Netzwerkzugriff](#netzwerkzugriff).

In Team- und Enterprise-Plänen können Admins den Skill mit **Publish to org** für die gesamte Organisation freigeben.

### Netzwerkzugriff

Damit Claude Desktop und Claude im Browser die Dokumentation abrufen können, muss docs.workist.com freigegeben sein: Erlauben Sie die Domain unter **Settings → Capabilities** bei **Allow network egress**. In Team- und Enterprise-Plänen legt das der Owner der Organisation unter **Organization settings → Capabilities** fest.

### Claude Code

Für alle Ihre Projekte:

```sh
mkdir -p ~/.claude/skills/workist-docs
curl -fsSL https://docs.workist.com/skills/workist-docs/SKILL.md -o ~/.claude/skills/workist-docs/SKILL.md
```

Für ein einzelnes Repository legen Sie die Datei stattdessen unter `.claude/skills/workist-docs/SKILL.md` im Repository ab. Dann steht der Skill allen zur Verfügung, die in diesem Repository arbeiten.

Damit Claude Code die Dokumentation ohne Rückfrage abrufen darf, erlauben Sie die Domain in `~/.claude/settings.json` oder in `.claude/settings.json` des Repositorys:

```json
{
  "permissions": {
    "allow": ["WebFetch(domain:docs.workist.com)"]
  }
}
```

### Andere KI-Agenten

Werkzeuge, die den offenen Standard [Agent Skills](https://agentskills.io) unterstützen, zum Beispiel Cursor, GitHub Copilot, Gemini CLI und OpenAI Codex, installieren den Skill mit:

```sh
npx skills add https://docs.workist.com/skills/workist-docs/SKILL.md
```

## Dokumentation als Markdown

Für KI-Assistenten ohne den Skill steht die Dokumentation nach dem Standard [llms.txt](https://llmstxt.org) bereit:

| Datei | Inhalt |
| --- | --- |
| [llms.txt](https://docs.workist.com/llms.txt) (Deutsch), [llms.txt](https://docs.workist.com/en/llms.txt) (Englisch) | Verzeichnis aller Seiten mit Kurzbeschreibung |
| [llms-full.txt](https://docs.workist.com/llms-full.txt) (Deutsch), [llms-full.txt](https://docs.workist.com/en/llms-full.txt) (Englisch) | Die gesamte Dokumentation in einer Datei |
| Adresse einer Seite mit der Endung `.md` | Die einzelne Seite als Markdown, zum Beispiel `https://docs.workist.com/docs/ai-assistants.md` |