Convex Best Practices skill

O que ela faz

Ensina o Claude as regras de produção do Convex, um banco de dados com backend em tempo real. Toda função com validação de entrada e saída, toda leitura de tabela por índice em vez de filtro, mutações que podem rodar duas vezes sem estragar nada e gravações independentes em paralelo.

Explica de onde vem o erro de conflito de gravação (write conflict): duas mutações no mesmo documento, uma leitura que pega a tabela inteira, um clique repetido rápido demais. E dá a saída pra cada caso: contador vira uma linha por evento, presença ganha uma janela contra repetição, lista que cresce passa a ser paginada.

Traz uma tabela de erros comuns com o porquê e o que fazer, um checklist pra revisar código e a instalação do @convex-dev/eslint-plugin, que pega alguns desses erros (filtro no lugar de índice, função sem validador) antes de subir. Inclui detalhes como não usar Date.now() dentro de query e usar ConvexError na mensagem que o usuário precisa ler.

Nas palavras de quem fez

Quando usar

• Revisar o backend de um app Convex que o Claude escreveu, antes de lançar
• Resolver o write conflict que aparece quando muita gente usa ao mesmo tempo
• Consertar uma lista que fica mais lenta a cada dia
• Configurar o ESLint do Convex num projeto novo

Depois de instalar, é só pedir assim

• Revisa a pasta convex/ com as boas práticas do Convex e corrige o que estiver fora
• Tá dando write conflict no contador de visualizações, resolve isso
• A lista de pedidos tá ficando lenta, coloca paginação e índice

Segurança

Gen Agent Trust Hub, Socket e Snyk leem o código da skill atrás de comando perigoso, dado vazando e instrução escondida. Alerta não é reprovação: quer dizer que vale ler o que a skill faz antes de instalar.

• Gen Agent Trust HubPassou
• SocketPassou
• SnykAlerta

Perguntas