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

# Habilidade do agente

> Instale a habilidade AppSignal incluída no Claude, Codex ou OpenCode para que seu agente de codificação com IA possa operar a CLI.

A CLI inclui uma habilidade de agente AppSignal: um conjunto de instruções que ensina um agente de codificação com IA a usar `appsignal-cli` para inspecionar seus dados do AppSignal. Instalá-la grava um `SKILL.md` no diretório de habilidades do agente, então o agente sabe quando recorrer à CLI e como ler sua saída JSON.

<Note>
  A habilidade ensina um agente a executar a CLI, então o agente age como você. Certifique-se de que a CLI esteja [autenticada](/cli/authentication) na máquina onde o agente é executado.
</Note>

## Instalar a habilidade

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

Por padrão, isso instala a habilidade para o OpenCode. Escolha um agente diferente, ou instale para todos eles, com `--target`:

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

# Codex
appsignal-cli skill install --target codex

# Todos os agentes suportados
appsignal-cli skill install --target all
```

### Agentes suportados

Cada alvo instala a mesma habilidade no diretório de habilidades padrão desse agente:

| Alvo                  | Instala em                                                                                                              |
| --------------------- | ----------------------------------------------------------------------------------------------------------------------- |
| `opencode` (o padrão) | `~/.agents/skills/appsignal/SKILL.md`                                                                                   |
| `codex`               | `$CODEX_HOME/skills/appsignal/SKILL.md`, ou `~/.codex/skills/appsignal/SKILL.md` quando `$CODEX_HOME` não está definido |
| `claude`              | `~/.claude/skills/appsignal/SKILL.md`                                                                                   |
| `all`                 | Todos os diretórios acima                                                                                               |

Mais duas flags ajustam onde e como a habilidade é instalada:

| Flag           | Descrição                                                            |
| -------------- | -------------------------------------------------------------------- |
| `--dir <path>` | Instala neste diretório raiz de habilidades em vez do padrão do alvo |
| `--force`      | Sobrescreve uma habilidade instalada existente                       |

`skill update` e `skill status` aceitam as mesmas flags `--target` e `--dir`, então você pode atualizar ou verificar uma habilidade instalada em uma localização personalizada.

## Mantenha a habilidade atualizada

Uma habilidade instalada registra a versão da CLI que a produziu. Após atualizar `appsignal-cli`, atualize suas instalações para a versão incluída:

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

Como `install`, `update` atua no OpenCode por padrão; passe `--target` para atualizar um agente diferente ou `all` deles.

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

## Verificar status da instalação

Para ver se suas habilidades instaladas estão atualizadas, desatualizadas ou ausentes:

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

`status` verifica todos os agentes suportados por padrão, então você obtém uma lista cobrindo OpenCode, Codex e Claude. Passe `--target` para restringir a um único agente.

## Próximos passos

A habilidade permite que um agente execute a CLI a partir do seu shell. Para agentes que se comunicam com o AppSignal diretamente via HTTP, veja [AppSignal MCP](/mcp-server).