> ## Documentation Index
> Fetch the complete documentation index at: https://docs.appsignal.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Agent Skill

> Installieren Sie das mitgelieferte AppSignal-Skill in Claude, Codex oder OpenCode, damit Ihr AI-Coding-Agent die CLI steuern kann.

Die CLI enthält ein AppSignal-Agent-Skill: eine Reihe von Anweisungen, die einem AI-Coding-Agent beibringen, wie er `appsignal-cli` verwendet, um Ihre AppSignal-Daten zu inspizieren. Die Installation schreibt eine `SKILL.md` in das Skills-Verzeichnis des Agents, sodass der Agent weiß, wann er nach der CLI greifen muss und wie er ihre JSON-Ausgabe liest.

<Note>
  Das Skill bringt einem Agent bei, die CLI auszuführen, sodass der Agent als Sie agiert. Stellen Sie sicher, dass die CLI auf der Maschine, auf der der Agent läuft, [authentifiziert](/cli/authentication) ist.
</Note>

## Das Skill installieren

```sh Shell theme={null}
appsignal-cli skill install
```

Standardmäßig installiert dies das Skill für OpenCode. Wählen Sie einen anderen Agent oder installieren Sie für alle mit `--target`:

```sh Shell theme={null}
# Claude
appsignal-cli skill install --target claude

# Codex
appsignal-cli skill install --target codex

# Every supported agent
appsignal-cli skill install --target all
```

### Unterstützte Agents

Jedes Ziel installiert dasselbe Skill in das Standard-Skills-Verzeichnis dieses Agents:

| Ziel                      | Installiert in                                                                                                           |
| ------------------------- | ------------------------------------------------------------------------------------------------------------------------ |
| `opencode` (der Standard) | `~/.agents/skills/appsignal/SKILL.md`                                                                                    |
| `codex`                   | `$CODEX_HOME/skills/appsignal/SKILL.md`, oder `~/.codex/skills/appsignal/SKILL.md`, wenn `$CODEX_HOME` nicht gesetzt ist |
| `claude`                  | `~/.claude/skills/appsignal/SKILL.md`                                                                                    |
| `all`                     | Alle oben genannten Verzeichnisse                                                                                        |

Zwei weitere Flags passen an, wo und wie das Skill installiert wird:

| Flag           | Beschreibung                                                                                |
| -------------- | ------------------------------------------------------------------------------------------- |
| `--dir <path>` | Installiert in dieses Skills-Stammverzeichnis anstatt in das Standard-Verzeichnis des Ziels |
| `--force`      | Überschreibt ein bereits installiertes Skill                                                |

`skill update` und `skill status` akzeptieren dieselben Flags `--target` und `--dir`, sodass Sie ein in einem benutzerdefinierten Speicherort installiertes Skill aktualisieren oder überprüfen können.

## Das Skill auf dem neuesten Stand halten

Ein installiertes Skill protokolliert die CLI-Version, die es erzeugt hat. Nach dem Upgrade von `appsignal-cli` aktualisieren Sie Ihre Installationen auf die mitgelieferte Version:

```sh Shell theme={null}
appsignal-cli skill update
```

Wie `install` agiert `update` standardmäßig auf OpenCode; übergeben Sie `--target`, um einen anderen Agent oder `all` von ihnen zu aktualisieren.

```sh Shell theme={null}
appsignal-cli skill update --target all
```

## Installationsstatus prüfen

Um zu sehen, ob Ihre installierten Skills aktuell, veraltet oder fehlend sind:

```sh Shell theme={null}
appsignal-cli skill status
```

`status` prüft standardmäßig alle unterstützten Agents, sodass Sie eine Liste erhalten, die OpenCode, Codex und Claude abdeckt. Übergeben Sie `--target`, um sie auf einen einzelnen Agent einzugrenzen.

## Nächste Schritte

Das Skill ermöglicht es einem Agent, die CLI von Ihrer Shell aus auszuführen. Für Agents, die stattdessen direkt über HTTP mit AppSignal sprechen, siehe [AppSignal MCP](/mcp-server).