// Agentes e skills //

roda no Claude Code

Uma skill para o Claude Code que faz o Claude montar, ou revisar, a cobrança por assinatura de um aplicativo com o Stripe. Serve a quem vai cobrar pela primeira vez e a quem já cobra e desconfia do que construiu. O Claude escreve o código e os testes; criar produto, preço, cupom e endpoint no painel do Stripe e colar chave de produção é seu, e a skill entrega a lista pronta. A regra central: só o webhook escreve o estado da assinatura. A tela de volta do checkout não libera nada, as ações da pessoa mudam o Stripe e esperam, e uma função única decide quem tem o plano, igual no banco e no aplicativo. Ela começa lendo o projeto e descobrindo em que ponto a cobrança está (sem cobrança, acesso liberado sem webhook, falta a conta da pessoa, retenção de quem quer sair ou ida a produção) e age conforme o caso. O que ela entrega: checkout com preço recorrente, preço avulso de entrada e período de avaliação, só para quem nunca assinou; o webhook como único escritor, com corpo cru, conferência da assinatura, tabela de eventos para não processar duas vezes e resposta certa para evento fora de ordem; uma função de acesso em SQL e em TypeScript, com a mesma lista de casos de teste nas duas pontas; portal, pausa e retomada; cancelamento com formulário e retenção, com o portão no servidor e a oferta calculada do cupom; cinco fichas de consulta (checkout, webhook, portal, cancelamento e produção), seis moldes prontos para adaptar e um conferidor, o conferir.py, que só lê o projeto e acusa chave do Stripe em arquivo, escrita na tabela de assinatura fora do webhook e webhook sem conferência de assinatura. Limites: a skill não cria nada no painel do Stripe, não cola chave e não faz compra, estorno nem cancelamento de verdade. Cobre um plano por pessoa; troca de plano, vários assentos, cobrança por uso, marketplace, nota fiscal e imposto ficam de fora. Os moldes são TypeScript e Postgres. Os parâmetros foram conferidos nos tipos da versão 23 do pacote stripe para Node, o SQL rodou em Postgres 18 e o teste de fronteira rodou em Vitest, mas nenhum molde foi executado contra uma conta do Stripe: o teste final é no seu modo de teste. O que as fichas marcam como "a conferir na documentação do Stripe" não foi verificado. O formulário obrigatório antes de cancelar tem risco de atrito e de regra de consumo: a skill avisa e registra a sua decisão, mas não avalia a legalidade. O conferidor lê texto, não segue imports e não entende escrita feita por ORM; não achar não prova que não há. Requisitos: Python 3.8 ou mais novo, só para o conferidor, que usa só a biblioteca padrão, não acessa a rede e nunca imprime o valor de uma chave. Para instalar, descompacte o .zip em ~/.claude/skills/.

• Roda no Claude Code
• Intermediário