postman-collectionslisted
Install: claude install-skill testland/qa
# postman-collections
## Overview
**Newman** is Postman's official CLI for running collections headlessly in CI
([newman-readme][readme]). The shape is two-step: author the collection in the
Postman app (or import an OpenAPI spec), save it as `collection.json`, then run
`newman run collection.json` in CI and emit JUnit / JSON for gating.
[readme]: https://github.com/postmanlabs/newman
This skill covers the headless Newman side. GUI authoring inside Postman is out
of scope; its reference is [learning.postman.com](https://learning.postman.com/).
## When to use
- The repo contains `*.postman_collection.json` (or the team
exports collections to `collections/`).
- API testing is the team's primary integration-testing layer and
the team is already in the Postman ecosystem.
- A CI workflow needs `newman run` with structured reporter output
for PR gating.
If the team uses TypeScript / JavaScript and prefers code-first
authoring, evaluate
`tavern-testing` (YAML) or
`karate-testing` (Karate DSL) before
adopting Postman/Newman - those keep tests next to source code rather
than in a separate JSON artifact.
## Install
```bash
npm install -g newman
```
(Per [newman-readme][readme].)
For per-project install (preferred for CI determinism):
```bash
npm install --save-dev newman
```
For the HTML reporter (external, separate install):
```bash
npm install --save-dev newman-reporter-htmlextra
```
## Running
The canonical invocation ([newman-readme][readme]):
```bash
newman