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

# Skills para editores de IA

> A CLI da Jelou instala skills (pacotes de capacidades em markdown) nos seus editores de IA para que um agente saiba operar a plataforma. Instale-as, atualize-as e gerencie suas versões.

A CLI da Jelou é **agente-nativa**: além de ser executada pelo terminal,
empacota **skills** — pacotes de capacidades em markdown — que são instalados nos
seus editores de IA. Uma vez instaladas, um agente (Claude Code, Cursor, Codex,
Windsurf, etc.) sabe quais comandos `jelou` existem, o que faz cada área de
produto e como encadeá-los, então você pode pedir em linguagem natural
*"faça o deploy desta função"* ou *"construa um fluxo de suporte"* e ele escolhe o
comando correto.

## Como funcionam

* No seu **primeiro `jelou login` bem-sucedido**, a CLI detecta os editores de IA
  instalados e instala as skills neles globalmente. As sessões novas nesses
  editores já conhecem o `jelou`.
* Cada skill é escrita como markdown em um diretório de skills do editor.
  A CLI escreve uma cópia canônica em `<root>/.agents/skills/<skill>/` e depois
  cria symlinks (ou cópias, em sistemas que bloqueiam symlinks) para o
  diretório de cada agente detectado.
* Todas as skills derivam sua versão da versão do binário da CLI: quando
  você atualiza o `jelou`, todas as skills são reportadas como atualizadas.

<Note>
  "Skill" aqui significa o **pacote markdown** que o `jelou agent install` escreve
  nos editores de IA. Não o confunda com o sentido legado de "skill" como
  *workflow* dentro de um projeto.
</Note>

## `jelou agent install`

Instala (ou reinstala) as skills manualmente. Em um terminal interativo
pergunta pelos agentes de destino, escopo, método de instalação e confirmação. Em
CI, modo JSON, modo agente ou com stdout redirecionado nunca pergunta.

```bash theme={null}
jelou agent install                                              # interativo
jelou agent install --global --targets codex --yes --no-input    # um agente
jelou agent install --global --all-targets --yes --no-input      # todos
jelou agent install --global --only project,whatsapp --targets codex,claude
```

| Flag                       | Descrição                                                                     |
| -------------------------- | ----------------------------------------------------------------------------- |
| `--global`                 | Instala no home do usuário (todos os projetos) em vez de no projeto atual     |
| `--targets <a,b>`          | Lista de agentes de destino específicos                                       |
| `--all-targets`            | Instala em todos os agentes detectados                                        |
| `--only <s1,s2>`           | Instala apenas as skills indicadas                                            |
| `--method <symlink\|copy>` | Método de instalação (`symlink` por padrão: uma única fonte de verdade)       |
| `--api`                    | Instala a variante do SDK focada em API quando disponível (somente Functions) |
| `--yes`                    | Pula a confirmação (para CI/não interativo)                                   |

### Editores de IA suportados

A CLI detecta e suporta estes destinos:

| Universal (`.agents/skills`)                                    | Específicos                                                                                    |
| --------------------------------------------------------------- | ---------------------------------------------------------------------------------------------- |
| Amp, Codex, Gemini CLI, GitHub Copilot, OpenCode, Kimi Code CLI | Claude Code (`.claude/skills`), Cursor (`.cursor/skills`), Windsurf, Cline, Continue, Roo Code |

## `jelou skills`

Inspeciona e gerencia as versões das skills instaladas.

```bash theme={null}
jelou skills list                          # skills empacotadas vs. instaladas
jelou skills check --skill jelou-functions # detecta se uma skill está desatualizada
jelou skills acknowledge --skill jelou-functions   # marca sua versão como vista
jelou skills ack-update --version 1.53.0   # descarta o aviso de update da CLI
```

| Subcomando                   | Descrição                                                                                            |
| ---------------------------- | ---------------------------------------------------------------------------------------------------- |
| `list`                       | Lista todas as skills com sua versão empacotada e instalada                                          |
| `check --skill <name>`       | Detecta drift e emite marcadores de versão (`CLI_OUTDATED`, `CLI_UPDATE_AVAILABLE`, `SKILL_UPDATED`) |
| `acknowledge --skill <name>` | Marca a versão de uma skill como vista; limpa a flag `SKILL_UPDATED`                                 |
| `ack-update --version <v>`   | Descarta o aviso `CLI_UPDATE_AVAILABLE` para essa versão                                             |

## Skills disponíveis

A CLI empacota estas skills (várias incluem variantes e arquivos de
referência adicionais):

| Skill                      | Cobre                                                                                          |
| -------------------------- | ---------------------------------------------------------------------------------------------- |
| `jelou`                    | Instalação, auth, perfis, modos de saída e navegação da CLI                                    |
| `jelou-functions`          | Funções serverless (variantes `cli` e `api`)                                                   |
| `jelou-databases`          | Bancos de dados gerenciados (alias `jelou-datum`)                                              |
| `jelou-project`            | Projetos, arquivos de conhecimento e canais                                                    |
| `jelou-whatsapp`           | Bots, modelos e campanhas de WhatsApp                                                          |
| `jelou-shop`               | Catálogo, produtos, pedidos e cupons do Jelou Shop (ecommerce)                                 |
| `jelou-debug-conversation` | Triagem de conversas de produção (logs)                                                        |
| `jelou-insights`           | Analítica de conversas: perguntas frequentes, fricção, sentimento e oportunidades de automação |
| `jelou-feedback`           | Enviar relatórios a partir da CLI                                                              |

Além disso, os **bundles BrainOps** são pacotes instaláveis mais completos (com
executáveis, referências e hooks) para construir e testar workflows:
`jelou-build-workflows` (construção de workflows), `jelou-test-workflow`
(QA de um workflow) e `jelou-audit-workflows` (auditorias read-only).

## Manter as skills atualizadas

Após atualizar a CLI, atualize as skills instaladas para que as sessões
novas vejam as mudanças:

```bash theme={null}
npm install -g @jelou/cli@latest
jelou --version
jelou agent install --global --all-targets --yes --no-input
```

<Tip>
  Se um agente não parecer conhecer o `jelou`, execute
  `jelou agent install --global` e abra uma **sessão nova** do editor — as
  skills são carregadas no início da sessão.
</Tip>
