Skill

postman-routing

Install
1
Install the plugin
$
npx claudepluginhub anthropics/claude-plugins-official --plugin postman

Want just this skill?

Add to a custom plugin, then install with one command.

Description

Automatically routes Postman and API-related requests to the correct command. Use when user mentions APIs, collections, specs, testing, mocks, docs, security, or Postman.

Tool Access

This skill uses the workspace's default tool permissions.

Skill Content

Postman Command Routing

When the user's request involves Postman or APIs, route to the appropriate command. Always prefer commands over raw MCP tool calls. Commands provide structured workflows, async handling, error diagnosis, and formatted output.

Routing Table

User IntentCommandWhy
Import a spec, push spec to Postman, create collection from spec/postman:syncCreates spec + collection + environment, handles async polling
Sync collection, update collection, keep in sync, push changes/postman:syncFull sync workflow with change reporting
Generate client code, SDK, wrapper, consume an API/postman:codegenReads collection shape, detects language, writes typed code
Find API, search endpoints, what's available, is there an API for/postman:searchSearches private workspace first, drills into details
Run tests, check if tests pass, validate API/postman:testRuns collection, parses results, diagnoses failures, suggests fixes
Create mock server, fake API, mock for frontend/postman:mockChecks for examples, generates missing ones, provides integration config
Generate docs, improve documentation, publish docs/postman:docsAnalyzes completeness, fills gaps, can publish to Postman
Security audit, check for vulnerabilities, OWASP/postman:security20+ security checks with severity scoring and remediation
Set up Postman, configure API key, first-time setup/postman:setupGuided setup with workspace verification
Is my API agent-ready?, scan my API, analyze my specreadiness-analyzer agent48 checks across 8 pillars, scoring and fix recommendations

Routing Rules

  1. Specific commands take priority. If the intent clearly maps to one command, use it.
  2. Agent-readiness questions go to the agent. Phrases like "agent-ready", "scan my API", "analyze my spec for AI" trigger the readiness-analyzer agent.
  3. Ambiguous requests get clarified. If you can't determine intent, ask: "I can sync collections, generate client code, search for APIs, run tests, create mocks, generate docs, or audit security. What do you need?"
  4. Multi-step requests chain commands. "Import my spec and run tests" = /postman:sync then /postman:test.

When to Use Raw MCP Tools

Only use mcp__postman__* tools directly when:

  • Making a single, targeted update (e.g., updating one request's body)
  • The user explicitly asks to call a specific MCP tool
  • The task doesn't match any command workflow
Stats
Stars3
Forks0
Last CommitFeb 13, 2026
Actions

Similar Skills