Install
npx skills add vercel-labs/konsistent --skill konsistent-configPara quem
Serve para quem já tem (ou vai escrever) convenções de estrutura em nível de projeto num repositório TypeScript, e quer uma CLI para conferir se arquivos e diretórios seguem esses padrões. O repositório oficial é https://github.com/vercel-labs/konsistent Ele confere se files and directories match declared structural patterns, e preenche a lacuna quando ESLint, Biome e oxlint só cobrem estilo dentro do arquivo e não verificam estrutura de projeto. Exemplos: every provider package must export the same shape, ou every adapter must extend the base class. Não é mais um estilizador de código.
Serve melhor para quem escreve konsistent.json primeiro e depois validate / check. Se o repositório ainda não tem convenções, não leia a primeira tentativa como reescrever automaticamente todos os arquivos. O material não nomeia um produto de agente obrigatório.
Primeira tentativa em 3 minutos
O caminho principal da skill instala primeiro a skill de configuração:
npx skills add vercel-labs/konsistent --skill konsistent-config
Pré-requisitos: o ambiente atual consegue executar npx e você está pronto para gravar ou inspecionar konsistent.json num repositório TypeScript. O material não escreve versão do Node. Confirme que o diretório pode receber configuração e então execute; o efeito colateral é instalar a skill konsistent-config. Depois, deixe a skill conferir ou rascunhar a configuração; não altere o código de negócio em lote.
Tarefa de baixo risco: num agente que já pode usar esta skill, só gere ou inspecione konsistent.json e então rode a conferência oficial:
konsistent validate
Sinal de sucesso: o arquivo de configuração passa Validate the konsistent.json configuration file, não que um monte de código já tenha sido reescrito. Se ainda não há CLI, o exemplo de dependência de desenvolvimento é npm install konsistent --save-dev; confirme que você pode gravar nesse repositório antes de executar. Não rode a skill de reparo nesta etapa.
Se a interface pedir um segredo que não aparece no material, ou quiser rodar todos os comandos de instalação de gerenciadores de uma vez, pare na hora.
Casos de uso
Caso 1: declarar e validar convenções de estrutura. Corresponde à skill konsistent-config e a konsistent validate. Serve para quem ainda não tem um konsistent.json estável e só quer escrever os padrões corretamente. Não há lista de campos; o confirmável é: configuração primeiro, depois validate. Não escreva o caso 1 como se o repositório inteiro já tivesse passado.
Caso 2: conferir segundo as convenções ou ver violações uma a uma. Corresponde a konsistent / konsistent check (Check structural conventions) e à segunda skill npx skills add vercel-labs/konsistent --skill konsistent-fix-violations. Serve para quem já validou a configuração e só quer ver quais arquivos fogem do padrão. check é relativamente reversível; fix-violations walks violations e pode alterar arquivos — confirme antes que o branch atual permite mudança. O material não diz que o reparo automático é sempre seguro.
Limites de uso
Não substitui regras dentro do arquivo de ESLint, Biome ou oxlint; só complementa estrutura de projeto. O material dá três instalações de dependência de desenvolvimento — NPM, PNPM, Bun. Na primeira tentativa escolha a que você já usa; não trate as três como execução obrigatória. konsistent é a forma curta de konsistent check; ambas precisam de um konsistent.json utilizável. Não há promessa de publicação, formatação ou repositórios que não sejam TypeScript. Não complete um método de instalação que não aparece.