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

# Agent Skills

> Skills of tema para agentes de código — instalar no init, atualizar e diagnosticar.

Agent Skills são instruções que a CLI instala no tema para o agente de código seguir o contrato público da Corvex. Elas não substituem `corvex validate`.

A versão das skills não é a versão da CLI nem a `version` do `theme.json`. Skills `1.1.0` (stable) e `1.0.0` (superseded) servem para tema com `manifestVersion: 2` e CLI `>= 2.4.0`. O instalador escolhe essa combinação. Não baixa arquivo da internet: o texto vem dentro de `@corvex/theme-cli`.

## Tema novo

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
corvex init minha-loja --name "Minha loja" --slug minha-loja
```

O scaffold termina com as skills em `.agents/skills/`. Para criar o tema sem elas:

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
corvex init minha-loja --slug minha-loja --no-skills
```

## Tema que já existe

Na raiz do tema (onde está `theme.json`):

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
corvex skills install .
```

O comando grava o que falta e recupera arquivo oficial ausente. Não substitui arquivo que você editou. Não apaga skill de terceiro na mesma pasta.

## Atualizar

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
corvex skills update . --yes
```

Sem `--yes` o comando só mostra o plano e não grava. `--force` junto com `--yes` substitui também o arquivo oficial que você editou. Skill de terceiro continua no lugar.

Se a versão instalada já é a compatível com o contrato, a mensagem diz que as skills já estão atualizadas.

## Ver o estado

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
corvex skills list .
corvex skills status .
corvex skills doctor .
```

`doctor` avisa arquivo editado, skill de terceiro e arquivo gerenciado que sumiu. Some arquivo oficial: rode `corvex skills install .` de novo.

`corvex validate .` continua válido do mesmo jeito. Se as skills não estão instaladas ou a versão não bate com o contrato, o validate acrescenta um aviso e não muda o resultado do tema.

## Onde o agente lê

O texto canônico fica em `.agents/skills/`. A CLI também cria um atalho para Cursor (`.cursor/skills`), Claude Code (`.claude/skills`) e Copilot (`.github/skills`). No Windows o atalho é uma junction. Se o sistema não permitir o atalho, a CLI copia e o `doctor` ainda olha o manifest em `.agents/skills/.corvex-skills.json`.

Codex lê `.agents/skills/` direto.

Um `AGENTS.md` que você já tinha permanece. A CLI só atualiza o bloco entre `corvex-agent-skills:start` e `corvex-agent-skills:end`.

## Desativar

```bash theme={"theme":{"light":"github-light","dark":"github-dark"}}
corvex skills disable .
```

Remove as skills oficiais que ninguém editou e os atalhos criados pela CLI. Pasta editada e skill de terceiro ficam. Para voltar: `corvex skills install .`.

## Conflito

Se `install` ou `update` encontrar um arquivo oficial diferente do que a CLI gravou, ele é preservado e o comando termina com erro. Nada é apagado em silêncio. Use `corvex skills update . --yes --force` só quando quiser descartar essa edição.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.