Comandos e automação para executar operações Postman (conversão OpenAPI, execução de testes, geração de relatórios).
70%
Does it follow best practices?
Run evals on this skill
Adds up to 20 points to the overall score
Passed
No findings from the security scan
Fix and improve this skill with Tessl
tessl review fix ./skills/documentation/postman-execution/SKILL.mdSkill para executar operações Postman: converter OpenAPI, executar testes, gerar relatórios.
Aplicar esta skill quando o agente for instruído a:
Comando: make postman-generate ou make postman-generate OPENAPI=openapi.json OUTPUT=postman
O que faz:
openapi-to-postmanv2 se necessáriopostman/collection.jsonQuando usar:
Exemplo:
# Usar defaults (openapi.json → postman/collection.json)
make postman-generate
# Especificar arquivo e diretório
make postman-generate OPENAPI=docs/swagger.json OUTPUT=postmanComando: make postman-test ou make postman-test COLLECTION=postman/collection.json ENV=postman/environment.json
O que faz:
Quando usar:
Exemplo:
# Usar defaults (postman/collection.json, postman/environment.json)
make postman-test
# Especificar collection e environment
make postman-test COLLECTION=postman/api.json ENV=postman/prod.jsonRelatórios gerados:
reports/postman/junit-results.xml - Para integração com CI/CDreports/postman/report.html - Relatório visual HTMLComando: make postman-validate ou make postman-validate COLLECTION=postman/collection.json
O que faz:
Quando usar:
Exemplo:
# Validar collection padrão
make postman-validate
# Validar collection específica
make postman-validate COLLECTION=postman/api.jsonComando: make postman-update ou make postman-update OPENAPI=openapi.json
O que faz:
Quando usar:
Exemplo:
# Atualizar collection padrão
make postman-update
# Especificar arquivo OpenAPI
make postman-update OPENAPI=docs/swagger.jsonmake ou diretamenteAntes de executar qualquer comando:
# Verificar se Node.js está instalado
node --version
# Verificar se collection existe (para testes)
test -f postman/collection.json
# Verificar se OpenAPI existe (para conversão)
test -f openapi.jsonApós executar:
1. Verificar se OpenAPI existe → Se não, informar usuário
2. Executar make postman-generate → Gerar collection
3. Validar collection → make postman-validate
4. Executar testes → make postman-test
5. Analisar relatórios → Reportar resultadosprojeto/
├── openapi.json # Ou swagger.json, docs/openapi.yaml
├── postman/
│ ├── collection.json # Collection gerada/atualizada
│ └── environment.json # Variáveis de ambiente
├── reports/
│ └── postman/ # Relatórios gerados (gitignored)
│ ├── junit-results.xml
│ └── report.html
└── Makefile # Comandos disponíveisAção:
openapi.json, swagger.json, docs/openapi.yamlAção:
make postman-generate primeiroAção:
Ação:
npm install -g openapi-to-postmanv2Antes de executar qualquer comando:
make quando disponível# Agente executa:
make postman-generate
# Analisa saída:
# ✅ Collection gerada em postman/collection.json
# ⚠️ PRÓXIMOS PASSOS: Adicionar scripts de autenticação
# Agente reporta:
"Collection Postman gerada com sucesso. Próximo passo: adicionar scripts de autenticação."# Agente executa:
make postman-test
# Analisa saída:
# ✅ 15/15 testes passaram
# Relatórios: reports/postman/report.html
# Agente reporta:
"Todos os testes passaram (15/15). Relatório disponível em reports/postman/report.html"# Agente executa:
make postman-update
# Analisa saída:
# ✅ Collection atualizada
# ⚠️ Verificar scripts customizados
# Agente reporta:
"Collection atualizada. Verifique se scripts de autenticação foram preservados."skills/documentation/postman/SKILL.mdcore/templates/postman-collection/f84a77a
If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.