ricneves-ai/flowgrammers-skills/api-test-suite-builder
Claude Code and agent skill by ricneves-ai/flowgrammers-skills
- community
Checking that the SKILL.md file is still in the repository.
Use quando o usuário pede para gerar testes de API, criar suites de testes de integração, testar endpoints REST ou construir testes de contrato.
Install
npx vskill@latest install ricneves-ai/flowgrammers-skills/api-test-suite-builderSKILL.md
The same SKILL.md was published earlier as ricneves-ai/flowgrammers-skills/api-test-suite-builder.
API Test Suite Builder
Nível: POWERFUL Categoria: Engineering Domínio: Testing / Qualidade de API
Visão Geral
Escaneia definições de rotas de API em diferentes frameworks (Next.js App Router, Express, FastAPI, Django REST) e auto-gera suites de testes abrangentes cobrindo autenticação, validação de entrada, códigos de erro, paginação, uploads de arquivo e limitação de taxa. Produz arquivos de teste prontos para execução com Vitest+Supertest (Node) ou Pytest+httpx (Python).
Capacidades Principais
- Detecção de rotas — escanear arquivos-fonte para extrair todos os endpoints de API
- Cobertura de autenticação — tokens válidos/inválidos/expirados, header de auth ausente
- Validação de entrada — campos ausentes, tipos errados, valores de limite, tentativas de injeção
- Matriz de códigos de erro — 400/401/403/404/422/500 para cada rota
- Paginação — primeira/última/vazia/páginas muito grandes
- Uploads de arquivo — válidos, muito grandes, tipo MIME errado, vazio
- Rate limiting — detecção de burst, limites por usuário vs. global
Quando Usar
- Nova API adicionada — gerar scaffold de testes antes de escrever a implementação (TDD)
- API legada sem testes — escanear e gerar cobertura de baseline
- Revisão de contrato de API — verificar se os testes existentes correspondem às definições de rota atuais
- Verificação de regressão pré-release — garantir que todas as rotas tenham pelo menos testes de fumaça
- Preparação para auditoria de segurança — gerar testes de entrada adversariais
Detecção de Rotas
Next.js App Router
Express
FastAPI
Django REST Framework
Padrões de Geração de Testes
Matriz de Testes de Autenticação
Para cada endpoint autenticado, gerar:
| Caso de Teste | Status Esperado | |
|---|---|---|
| Sem header Authorization | 401 | |
| Formato de token inválido | 401 | |
| Token válido, papel de usuário errado | 403 | |
| Token JWT expirado | 401 | |
| Token válido, papel correto | 2xx | |
| Token de usuário excluído | 401 |
Matriz de Validação de Entrada
Para cada endpoint POST/PUT/PATCH com corpo de requisição:
| Caso de Teste | Status Esperado | |
|---|---|---|
Corpo vazio {} | 400 ou 422 | |
| Campos obrigatórios ausentes (um por vez) | 400 ou 422 | |
| Tipo errado (string onde int é esperado) | 400 ou 422 | |
| Limite: valor em min-1 | 400 ou 422 | |
| Limite: valor em min | 2xx | |
| Limite: valor em max | 2xx | |
| Limite: valor em max+1 | 400 ou 422 | |
| Injeção SQL em campo string | 400 ou 200 (sanitizado) | |
| Payload XSS em campo string | 400 ou 200 (sanitizado) | |
| Valores null para campos obrigatórios | 400 ou 422 |
Exemplos de Arquivos de Teste
→ Ver references/example-test-files.md para detalhes
Gerando Testes a Partir do Escaneamento de Rotas
Quando dado uma base de código, siga este processo:
- Escanear rotas usando os comandos de detecção acima
- Ler cada handler de rota para entender:
- Schema do corpo da requisição esperado
- Requisitos de autenticação (middleware, decoradores)
- Tipos de retorno e status codes
- Regras de negócio (propriedade, verificações de papel)
- Gerar arquivo de teste por grupo de rotas usando os padrões acima
- Nomear testes descritivamente:
"retorna 401 quando o token está expirado"não"teste de auth 3" - Usar factories/fixtures para dados de teste — nunca codificar IDs diretamente
- Verificar o shape da resposta, não apenas o status code
Armadilhas Comuns
- Testar apenas caminhos felizes — 80% dos bugs vivem nos caminhos de erro; teste esses primeiro
- IDs de dados de teste codificados — use factories/fixtures; IDs mudam entre ambientes
- Estado compartilhado entre testes — sempre limpe em afterEach/afterAll
- Testar implementação, não comportamento — teste o que a API retorna, não como ela faz
- Testes de limite ausentes — erros de um-a-mais são extremamente comuns em paginação e limites
- Não testar expiração de token — tokens expirados se comportam diferente de tokens inválidos
- Ignorar Content-Type — teste que a API rejeita tipos de conteúdo errados (xml quando json é esperado)
Melhores Práticas
- Um bloco describe por endpoint — mantém falhas isoladas e legíveis
- Semeie dados mínimos — não carregue o banco inteiro; crie apenas o que o teste precisa
- Use
beforeAllpara configuração compartilhada,afterAllpara limpeza — nãobeforeEachpara operações caras - Verifique mensagens/campos de erro específicos, não apenas status codes
- Teste que campos sensíveis (senha, secret) nunca aparecem nas respostas
- Para testes de autenticação, sempre teste o caso de "header ausente" separadamente de "token inválido"
- Adicione testes de rate limit por último — podem interferir com outras suites de testes se executados em paralelo
Security
- Security scanPassed, 95 of 100Pattern checks on the skill's files.
- Model reviewPassed
Quality evaluation
- Task evaluationNot runNo evaluation yet. Run one in Skill Studio.
Source
- SKILL.md in the repositoryCheckingengineering/api-test-suite-builder/SKILL.md
Popularity
- Repository stars
- 115
- Repository forks
- 45
- 7-day trend score
- 29
Stars and forks are for the whole GitHub repository, not this skill alone. Not refreshed yet.
Works with
Any agent vskill installs to: 56 targets in all. These 39 have a page on this site.
- Claude Code
- Cursor
- GitHub Copilot
- Windsurf
- Codex
- Gemini CLI
- Cline
- Amp
- Roo Code
- Goose
- Continue
- Kilo Code
- Junie
- Trae
- OpenHands
- Qwen Code
- AI Agent
- Tabnine Chat
- Sourcegraph Cody
- Amazon Q
- Firebase Genkit
- Sweep
- Devin
- Phind
- Mentat
- Claude Desktop
- Aider
- GPT Pilot
- Plandex
- bolt.new
- v0
- Replit Agent
- Anse
- TypingMind
- BetterChatGPT
- LibreChat
- Warp AI
- Pieces
- Fig AI
Embed badge
[](https://verified-skill.com/skills/ricneves-ai/flowgrammers-skills/api-test-suite-builder)