> ## 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.

# Skill d'agent

> Installez le skill AppSignal intégré dans Claude, Codex ou OpenCode pour que votre agent de codage IA puisse piloter la CLI.

La CLI intègre un skill d'agent AppSignal : un ensemble d'instructions qui apprend à un agent de codage IA comment utiliser `appsignal-cli` pour inspecter vos données AppSignal. L'installer écrit un fichier `SKILL.md` dans le répertoire skills de l'agent, afin que l'agent sache quand recourir à la CLI et comment lire sa sortie JSON.

<Note>
  Le skill apprend à un agent à exécuter la CLI, donc l'agent agit en votre nom. Assurez-vous que la CLI est [authentifiée](/cli/authentication) sur la machine où s'exécute l'agent.
</Note>

## Installer le skill

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

Par défaut, cela installe le skill pour OpenCode. Choisissez un agent différent, ou installez pour tous, avec `--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
```

### Agents pris en charge

Chaque cible installe le même skill dans le répertoire skills par défaut de cet agent :

| Cible                   | S'installe dans                                                                                                       |
| ----------------------- | --------------------------------------------------------------------------------------------------------------------- |
| `opencode` (par défaut) | `~/.agents/skills/appsignal/SKILL.md`                                                                                 |
| `codex`                 | `$CODEX_HOME/skills/appsignal/SKILL.md`, ou `~/.codex/skills/appsignal/SKILL.md` quand `$CODEX_HOME` n'est pas défini |
| `claude`                | `~/.claude/skills/appsignal/SKILL.md`                                                                                 |
| `all`                   | Tous les répertoires ci-dessus                                                                                        |

Deux options supplémentaires ajustent où et comment le skill est installé :

| Option         | Description                                                                                |
| -------------- | ------------------------------------------------------------------------------------------ |
| `--dir <path>` | Installer dans ce répertoire racine des skills au lieu de la valeur par défaut de la cible |
| `--force`      | Écraser un skill installé existant                                                         |

`skill update` et `skill status` acceptent les mêmes options `--target` et `--dir`, vous pouvez donc mettre à jour ou vérifier un skill installé dans un emplacement personnalisé.

## Garder le skill à jour

Un skill installé enregistre la version de la CLI qui l'a produit. Après avoir mis à niveau `appsignal-cli`, rafraîchissez vos installations vers la version intégrée :

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

Comme `install`, `update` agit sur OpenCode par défaut ; passez `--target` pour mettre à jour un autre agent ou `all` d'entre eux.

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

## Vérifier le statut d'installation

Pour voir si vos skills installés sont à jour, obsolètes ou manquants :

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

`status` vérifie tous les agents pris en charge par défaut, vous obtenez donc une seule liste couvrant OpenCode, Codex et Claude. Passez `--target` pour la restreindre à un seul agent.

## Prochaines étapes

Le skill permet à un agent d'exécuter la CLI depuis votre shell. Pour les agents qui communiquent directement avec AppSignal via HTTP à la place, voir [AppSignal MCP](/mcp-server).