Agent skill · Documentation

postman-openapi-converter

Convert OpenAPI 3.x or Swagger 2.0 specs (YAML or JSON) into complete, import-ready Postman Collection v2.1 JSON files. Use this skill whenever the user provides or references an OpenAPI spec, Swagger file, openapi.yaml, swagger.json, or uses phrases like "convert my OpenAPI spec",...

Nick44,086★ · +407/wk · 1 repos on radarProfile →
claude-codecodexcursorMIT
Install
npx skills add sickn33/agentic-awesome-skills --skill postman-openapi-converter --agent claude-code

Same command for any agent — swap --agent for codex, cursor, copilot.

Facts
Files in the skill folder: 1
SKILL.md size: 6 KB
Bundled scripts: none
Path: skills/postman-openapi-converter/SKILL.md
Open the folder on GitHub →
Where it comes from
Stars: 44,414 · +328 this week
Language: Python
Read our review of the source →

Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.

From the SKILL.md

# OpenAPI → Postman Collection Converter ## When to Use Use this skill when you need convert OpenAPI 3.x or Swagger 2.0 specs (YAML or JSON) into complete, import-ready Postman Collection v2.1 JSON files. Use this skill whenever the user provides or references an OpenAPI spec, Swagger file, openapi.yaml, swagger.json, or uses phrases like "convert my OpenAPI spec",... Converts **OpenAPI 3.x** or **Swagger 2.0** specs into a valid **Postman Collection v2.1**. --- ## Step 1 — Detect & Validate Input Identify the spec version from the input: - `openapi: 3.x.x` → OpenAPI 3 - `swagger: "2.0"` → Swagger 2 If the input is truncated or partial, convert what's available and note missing sections. --- ## Step 2 — Extraction Mapping ### OpenAPI 3 → Postman | OpenAPI field | Postman mapping | |---|---| | `info.title` | Collection name | | `info.description` | Collection description | | `servers[0].url` | `{{base_url}}` variable | | `paths.<path>.<method>` | One request item per operation | | `operationId` or `summary` | Request name | | `parameters` (path/query/header) | URL path variables, query params, headers | | `requestBody.content.application/json.schema` | Body (raw JSON), generate exam

What's inside
Steps it walks through
  1. When to Use
  2. Step 1 — Detect & Validate Input
  3. Step 2 — Extraction Mapping
  4. OpenAPI 3 → Postman
  5. Swagger 2 → Postman
  6. Step 3 — Generate Example Bodies
  7. Step 4 — Auth Handling
  8. Step 5 — Build Collection JSON
  9. Step 6 — Environment File
  10. Step 7 — Output
  11. Edge Cases
  12. Quality Checklist
  13. After Completing the API Design
  14. Limitations
More from agentic-awesome-skills
All skills →
About this skill
What does the postman-openapi-converter skill do?

Convert OpenAPI 3.x or Swagger 2.0 specs (YAML or JSON) into complete, import-ready Postman Collection v2.1 JSON files. Use this skill whenever the user provides or references an OpenAPI spec, Swagger file, openapi.yaml, swagger.json, or uses phrases like "convert my OpenAPI spec",...

How do I install it?

Run `npx skills add sickn33/agentic-awesome-skills --skill postman-openapi-converter --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.

Where does this skill come from?

From sickn33/agentic-awesome-skills, a repository with 44,414 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.

Is a popular skill a good skill?

Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.

Keep going