postman-integration

Synchronize Postman collections and environments between Postman Cloud and repository YAML files.

Updated Apr 12, 2026
One-click install
npx skills add https://github.com/trezero/archon-trinity --skill postman-integration
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: postman-integration
Source: https://github.com/trezero/archon-trinity/tree/main/integrations/claude-code/extensions/postman-integration
Command: npx skills add https://github.com/trezero/archon-trinity --skill postman-integration

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Keeps Postman collections, environments, and test scripts consistent between Postman Cloud and a repository-based collection representation, removing manual syncing, duplicate requests, and missing environment variables that break API testing workflows.

Core Features & Use Cases

  • Mode-aware sync: automatically detects and respects API, git, or disabled sync modes and branches behavior accordingly.
  • Add and maintain requests: always add requests (not just curl snippets), include after-response test scripts to capture IDs, and prevent duplicates by checking existing collection entries or request files.
  • Git-first scaffolding and environment management: generate postman collection YAML files, environment files, and folder ordering when in git mode, or call MCP tools to manage collections and environments in API mode.
  • Use case: scaffold a project's Postman collection, add create/read/update/delete requests with test scripts that set collection variables, and sync those changes to Postman Cloud or to repository YAML files.

Quick Start

Add a POST /api/projects request to the project's Postman collection with an after-response test that saves projectId and sync it to Postman Cloud.

Frequently Asked Questions about postman-integration

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep Postman collections in sync with repository YAML files?

Postman collection sync is maintained by automatically synchronizing and maintaining requests, environments, and metadata across Postman Cloud and repository YAML files using mode-aware detection for API or git workflows.

How do I add a new API request to a Postman collection with environment variables?

To add API requests to a Postman collection, the assistant scaffolds the request with after-response test scripts to capture IDs, manages environment variables, and prevents duplicates by checking existing collection entries.

What is the best way to prevent duplicate requests when syncing Postman collections?

Preventing duplicate requests during Postman collection sync is handled by automatically checking existing collection entries or request files before adding new ones, ensuring consistent metadata across Postman Cloud and repository YAML files.

Does Postman collection sync work in both API mode and git mode?

Postman collection sync supports both API and git modes. In API mode it uses MCP tools to manage collections and environments in Postman Cloud, while in git mode it scaffolds and generates repository YAML files.

Why do my Postman environment variables break when syncing API testing workflows?

Postman environment variables break during API testing sync when required YAML fields like $kind and order are missing, or when environment variable management fails to properly map values between Postman Cloud and repository files.

What do I need to scaffold a Postman collection in git mode?

Scaffolding a Postman collection in git mode requires generating collection YAML files with required fields like $kind and order, alongside environment files and folder ordering to maintain consistent API testing workflows.