Convex Agent Skills: invocar skills em fluxos Convex comuns

Para quem

Instalar este conjunto só quando um agente precisar tratar common Convex workflows. A entrada oficial de topo é convex: Top-level entry point for Convex work. Recommends installing Convex AI files, then routes to a more specific Convex skill.

Serve a quem já trabalha com Convex e aceita deixar o skill de topo recomendar primeiro, depois entrar num fluxo concreto. O texto dá vários prefixos de invocação: Cursor, VS Code (GitHub Copilot) e Claude Code usam /skill-name, Windsurf @skill-name, Codex (OpenAI) $skill-name. Compara grafias de invocação; não ler como suporte só destes produtos.

Página: https://github.com/get-convex/agent-skills

Concluir uma primeira tentativa em 3 minutos

Usar só este comando principal de instalação:

npx skills add get-convex/agent-skills

Pré-condição: a tarefa atual é um fluxo Convex; a mesma página tem uma variante --all, que não se usa na primeira vez. O texto oficial não escreve um diretório em disco; não inventar um caminho.

Depois de instalar, fazer primeiro uma verificação só de leitura; não correr a montagem de auth. Confirmar com o agente: o que faz o skill de topo convex e que prefixo usar na ferramenta atual. O sinal de sucesso é reformular recommends installing Convex AI files, then routes to a more specific Convex skill e dizer, segundo a tabela, um de /skill-name, @skill-name ou $skill-name. Se começar a alterar auth ou a escrever Convex AI files não nomeados, parar primeiro.

Casos de uso

Caso 1: começar pela entrada de topo convex. Invocar primeiro esse skill, deixá-lo recomendar se instalar Convex AI files e depois encaminhar para um Convex skill mais concreto. Pode escrever ficheiros; antes de executar, confirmar que se aceita a instalação de ficheiros recomendada. A página não nomeia esses ficheiros — não inventar; pedir só que recomende e encaminhe segundo o texto original.

Caso 2: iniciar a montagem de auth. O exemplo oficial é For example, to kick off auth setup in Cursor or Claude Code: /convex-setup-auth. Altera conteúdo de auth do projeto; confirmar antes de invocar. O sinal de sucesso é o agente iniciar auth setup com este comando já escrito, não com um comando de auth inventado. Outros nomes concretos de skills não estão no texto; não acrescentar.

Limites de uso

O mesmo trecho também escreve npx skills add get-convex/agent-skills --all, com a nota Install all skills. É uma variante opcional, não o caminho principal da primeira tentativa.

Os prefixos de invocação mudam conforme a ferramenta; seguir a tabela; não alargar um prefixo a todos os ambientes.

Fora de convex e /convex-setup-auth não há outros nomes de skills. skill-name na tabela é grafia de marcador, não um nome real instalável.

Não há passos de chave secreta nem comando de desinstalação. Não acrescentar bases de dados, deploys nem nomes de funções que não estejam escritos.