Install
npx skills add clerk/skillsPara quem é
Use este conjunto de skills quando quiser que um Agent de código trate a autenticação Clerk com mais fluidez — sobretudo para acrescentar Clerk a um projeto novo ou a qualquer framework, ou para verificar utilizadores, organizações, apps, chaves de ambiente e deploys. Os skills seguem o formato Agent Skills e destinam-se a programadores que precisam de Clerk no repositório e querem que o Agent escolha o skill certo antes de mexer. O texto oficial marca /clerk como router e diz para começar sempre aí; não nomeie um skill filho de imediato. Antes de começar, tem de conseguir abrir o Clerk Dashboard e obter chaves que se possam escrever num ficheiro de ambiente; senão a integração e as verificações param por falta de chaves.
Conclua a primeira tentativa em 3 minutos
Siga só o comando de instalação do repositório oficial:
npx skills add clerk/skills
Depois de instalar, prepare primeiro as chaves; não complete com placeholders. Abra o Clerk Dashboard, copie a chave publicável e a chave secreta e escreva-as no .env do projeto. Os nomes das chaves têm de ser NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY e CLERK_SECRET_KEY. Antes de escrever, faça o Agent repetir só esses dois nomes e o ficheiro-alvo; só permita a alteração depois de confirmar.
Na primeira tarefa, escolha uma verificação reversível, não uma mudança de framework. Num cliente que já carregou os skills, escreva /clerk, diga que quer uma verificação de deploy ou conferir chaves de ambiente, e deixe o router levá-lo a clerk-cli. Antes de qualquer comando, exija que o Agent diga que vai chamar uma verificação CLI e não vai criar utilizadores nem alterar organizações. Execute só depois de confirmar.
Sinal de sucesso: o Agent passa de /clerk para clerk-cli e devolve resultados de chaves de ambiente ou de verificação de deploy, em vez de skill em falta ou chave em falta. Se usar Codex, o texto oficial tem um comando de adição no marketplace à parte; depois de adicionar, reinicie, abra /plugins, escolha Clerk Skills, instale e ative clerk-skills e abra um fio novo. Essa sequência é só do Codex; não a trate como instalação predefinida.
Casos de uso
Caso 1: integrar um projeto novo ou qualquer framework. O skill oficial clerk-setup acrescenta Clerk a qualquer framework, para projetos novos e init de framework. O caminho é primeiro /clerk, indicar o framework atual e «só adicionar a integração Clerk», e deixar o router aterrar em clerk-setup. Este tipo de tarefa altera ficheiros do projeto; o Agent tem de listar os ficheiros que vai mudar e você confirma antes de escrever. A página não dá uma lista concreta de frameworks nem patches passo a passo; o detalhe de framework segue as notas do skill após a instalação.
Caso 2: verificações operacionais só de leitura via CLI. clerk-cli cobre utilizadores, organizações, apps, chaves de ambiente e verificações de deploy. Depois de as chaves estarem no .env, serve para ver se uma app existente pode fazer deploy, se as chaves estão completas, ou para ver utilizadores e organizações em só leitura. Outra vez /clerk primeiro e depois clerk-cli. A página não lista subcomandos CLI concretos; não invente nomes de comando. O que se pode confirmar são as categorias de verificação acima; o formato de saída segue a execução real.
Limites de uso
Sem chaves do Dashboard, não comece a integração. O ficheiro de ambiente usa só os dois nomes que o texto oficial escreveu; não os mude para variáveis não documentadas. A instalação predefinida é npx skills add clerk/skills; a do marketplace só vale para Codex e tem de ativar clerk-skills pela ordem oficial. Comece sempre em /clerk; a página não descreve outras entradas como forma de saltar o router. O texto oficial não lista um elenco completo de clientes; não infira suporte exclusivo do exemplo Codex nem cobertura de linguagens dos exemplos da página. Não complete diretórios de skills, comandos de marketplace nem amostras de chaves não escritos. Página do repositório:
https://github.com/clerk/skills
Dashboard:
https://dashboard.clerk.com/