Postman Agent Skill

What is This?

This is an Agent Skill - a structured way to give Claude new capabilities through organized instructions and executable code. Agent Skills use progressive disclosure: Claude loads only what it needs when it needs it, keeping context usage efficient.

What’s Included in This POC

Core Components

• SKILL.md: Entry point with metadata, overview, and capability descriptions
• config.py: Environment variable management and validation
• postman_client.py: API client with retry logic and error handling
• retry_handler.py: Exponential backoff for rate limits and errors
• formatters.py: Human-readable output formatting
• list_collections.py: Executable script to discover workspace resources

Workflows

• list_collections.md: Step-by-step guide for discovering workspace resources
• manage_specs.md: 🆕 Create and manage API specifications in Spec Hub (OpenAPI 3.0, AsyncAPI 2.0)
• validate_schema.md: Validate API schemas against OpenAPI/Swagger standards
• version_comparison.md: Compare API versions and identify changes
• manage_collections.md: Create, update, delete, and duplicate collections
• manage_environments.md: Create, update, delete, and duplicate environments
• check_auth.md: Review authentication configuration and security
• manage_mocks.md: Create and manage mock servers for prototyping
• run_collection.md: Execute collection tests with Newman and analyze results
• manage_monitors.md: Create, manage, and analyze monitors for continuous API monitoring
• view_documentation.md: Access and assess API documentation quality

Capabilities

✅ Discover Phase

• List collections, environments, monitors, and APIs
• Get detailed resource information
• Workspace resource discovery
• Error handling with retry logic

✅ Design Phase

• 🆕 Spec Hub: Create and manage API specifications (OpenAPI 3.0, AsyncAPI 2.0)
• 🆕 Multi-File Specs: Support for modular specifications with separate schema files
• 🆕 Bidirectional Generation: Generate collections from specs or specs from collections
• Validate API schemas (OpenAPI, Swagger, GraphQL)
• Get API versions and compare changes
• Manage API definitions and versions
• Create, update, and delete APIs (legacy - use Spec Hub instead)

✅ Build Phase

• Create new collections and environments
• Update existing collections and environments
• Delete collections and environments
• Duplicate collections and environments
• Add requests to collections
• Manage environment variables (including secrets)

✅ Test Phase

• Run collection tests with Newman integration
• Execute test suites with environment variables
• Parse and format test results