Our review
This skill runs and analyzes Newman (Postman CLI) tests for API validation.
Strengths
- Automates Postman collection execution via command line.
- Provides detailed result analysis scripts (JSON, JUnit).
- Integrates smoothly into CI/CD pipelines.
- Includes collection structure validation.
Limitations
- Requires Newman and Python to be installed beforehand.
- Scripts are specific to this skill and may need customization.
- Does not handle advanced Postman environment or variable management.
Use this skill when you need to run API tests from an existing Postman collection, either locally or in a CI pipeline.
Avoid this skill if you do not have a ready Postman collection or if your API tests require complex interactions not supported by Newman.
Security analysis
SafeThe skill executes npm install and runs test scripts, but does so in a controlled manner for legitimate API testing purposes. There is no exfiltration, obfuscation, or destructive behavior. It uses Bash, Read, Write tools which are standard for such tasks.
No concerns found
Examples
Run the Newman tests from my Postman collection file and analyze the results.Validate my Postman collection structure to ensure it's correct before running tests.Execute the API tests optimized for CI with JUnit output and collect the results.name: newman-runner description: Run and analyze Newman (Postman CLI) tests. Use when running API tests, validating Postman collections, testing HTTP endpoints, or when user mentions Newman, Postman tests, API validation. allowed-tools: Bash, Read, Write
Newman Runner
This skill provides tools to run Newman (Postman CLI) tests and analyze the results for API testing and validation.
Instructions
Running Newman Tests
-
Verify Newman Installation
- Check if Newman is installed:
which newman - If not installed, install with:
npm install -g newman
- Check if Newman is installed:
-
Run Collection
- Use script:
scripts/run-newman.sh <collection.json> - Or manually:
newman run collection.json --reporters cli,json --reporter-json-export output.json
- Use script:
-
Analyze Results
- Parse JSON output with:
scripts/analyze-newman-results.py output.json - Extract: Pass/fail status, response times, error messages, assertions
- Parse JSON output with:
-
Run in CI/CD
- Use
scripts/run-newman-ci.sh <collection.json>for CI-optimized execution - Produces JUnit XML for CI reporting + JSON for analysis
- Uses GitHub Actions annotation format for inline error reporting
- Use
Available Scripts
scripts/run-newman.sh- Run Newman with standard optionsscripts/run-newman-ci.sh- CI-optimized runner with JUnit outputscripts/analyze-newman-results.py- Parse Newman JSON outputscripts/validate-collection.sh- Validate Postman collection structure
Advanced Patterns
For OpenAPI-to-Newman pipeline, auth injection, and collection management, see the api-contract-testing skill which builds on this runner.
Examples
Example 1: Run API Tests
# Run Newman tests on Postman collection
./scripts/run-newman.sh my-api-tests.json
# Analyze results
./scripts/analyze-newman-results.py newman-results.json
Example 2: Validate Collection
# Check collection is valid before running
./scripts/validate-collection.sh my-collection.json
Example 3: Run in CI
# CI-optimized run with JUnit output
./scripts/run-newman-ci.sh my-api-tests.json
# Results in:
# test-results/api-contract/newman-results.json (JSON)
# test-results/api-contract/newman-junit.xml (JUnit XML)
Requirements
- Newman installed globally:
npm install -g newman - Valid Postman collection JSON file
- Python 3.7+ for analysis scripts
Success Criteria
- Newman tests run successfully
- Results parsed and analyzed
- Pass/fail status clearly reported
- Error details extracted for failures
TDD Red-Green-Refactor
Testing
Skill that guides Claude through the complete TDD cycle.
Web Accessibility Audit
Testing
Performs a comprehensive web accessibility audit following WCAG standards.
UAT Test Case Generator
Testing
Generates structured and comprehensive user acceptance test cases.