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

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:

corvex init minha-loja --slug minha-loja --no-skills

Tema que já existe

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

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

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

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

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.