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",...
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.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
# 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
- When to Use
- Step 1 — Detect & Validate Input
- Step 2 — Extraction Mapping
- OpenAPI 3 → Postman
- Swagger 2 → Postman
- Step 3 — Generate Example Bodies
- Step 4 — Auth Handling
- Step 5 — Build Collection JSON
- Step 6 — Environment File
- Step 7 — Output
- Edge Cases
- Quality Checklist
- After Completing the API Design
- Limitations
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.