Agent skill

Postman Openapi Converter

by sickn33 in sickn33/agentic-awesome-skills

Convert OpenAPI 3.x or Swagger 2.0 specs (YAML or JSON) into complete, import-ready Postman Collection v2.1 JSON files.

MITAuto-check passedBackend & APIs

Install Postman Openapi Converter

skills CLI
$ npx skills add sickn33/agentic-awesome-skills --skill postman-openapi-converter -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install sickn33/agentic-awesome-skills postman-openapi-converter --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/sickn33/agentic-awesome-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/skills/postman-openapi-converter .claude/skills/postman-openapi-converter && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
postman-openapi-converter
GitHub stars
47k
Used in
1 other repo
Token cost
~1.5k tokens
SKILL.md length
661 words
Files
1
Skills in repo
1,493
Repo updated
First seen
Licence
MIT

At a glance

Convert OpenAPI 3.x or Swagger 2.0 specs (YAML or JSON) into complete, import-ready Postman Collection v2.1 JSON files.

  • Works in 7 steps: Detect & Validate Input → Extraction Mapping → Generate Example Bodies → …
  • Tasks that involve OpenAPI specifications
  • SKILL.md covers When to Use, Step 1 — Detect & Validate Input, Step 2 — Extraction Mapping and Step 3 — Generate Example Bodies, plus 8 more sections
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Postman Openapi Converter is an agent skill from sickn33/agentic-awesome-skills. Convert OpenAPI 3.x or Swagger 2.0 specs (YAML or JSON) into complete, import-ready Postman Collection v2.1 JSON files.

Its SKILL.md is about 1.5k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Backend & APIs, covering OpenAPI specifications and API testing. It works with OpenAPI and Postman. The repository describes itself as: AAS Core is the local, agent-first control plane for complete catalog discovery, agent-owned selection, stack validation, and planning, backed by 2,400+ agentic skills. Includes… The licence is MIT.

When your agent uses it

  • Tasks that involve OpenAPI specifications
  • Tasks that involve API testing

Example prompts

  • “/postman-openapi-converter”

Workflow steps

7 steps, taken from the step headings in SKILL.md.

  1. Detect & Validate Input
  2. Extraction Mapping
  3. Generate Example Bodies
  4. Auth Handling
  5. Build Collection JSON
  6. Environment File
  7. Output

What it can do on your machine

Read from SKILL.md and the folder at commit 680176d. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Postman Openapi Converter loads about 1.5k tokens when it runs. Until then it costs about 36 tokens; SKILL.md has 661 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~36
When it runs · the whole SKILL.md, loaded when a task matches
~1.5k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from sickn33/agentic-awesome-skills at commit 680176d, republished under its MIT licence (© sickn33). 661 words, ~1,511 tokens.

Download SKILL.mdSave it as .claude/skills/postman-openapi-converter/SKILL.md (or your agent's skills folder).
name
postman-openapi-converter
description
Convert OpenAPI 3.x or Swagger 2.0 specs (YAML or JSON) into complete, import-ready Postman Collection v2.1 JSON files.
risk
critical
source
https://github.com/LambdaTest/agent-skills/tree/main/api-skill/postman/postman-openapi-converter
source_repo
LambdaTest/agent-skills
source_type
community
date_added
2026-07-01
license
MIT
license_source
https://github.com/LambdaTest/agent-skills/blob/main/LICENSE

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 fieldPostman mapping
info.titleCollection name
info.descriptionCollection description
servers[0].url{{base_url}} variable
paths.<path>.<method>One request item per operation
operationId or summaryRequest name
parameters (path/query/header)URL path variables, query params, headers
requestBody.content.application/json.schemaBody (raw JSON), generate example from schema
responsesSaved example responses
components.securitySchemesCollection-level auth
tagsFolder grouping
Swagger 2 → Postman
Swagger fieldPostman mapping
host + basePath{{base_url}}
paths.<path>.<method>Request item
parametersQuery/path/header/body params
consumes / producesContent-Type / Accept headers
securityDefinitionsCollection auth
tagsFolders

Step 3 — Generate Example Bodies

For each request with a requestBody or body parameter, generate a realistic example JSON body from the schema:

  • Use property names as keys
  • Infer sensible example values from type + format (e.g., "email" format → "user@example.com", "date-time" → "2024-01-15T10:30:00Z")
  • For $ref schemas, resolve them inline

Step 4 — Auth Handling

Map security schemes to Postman auth:

OpenAPI schemePostman auth type
http: bearerbearer with {{token}}
http: basicbasic with {{username}} / {{password}}
apiKey: headerapikey header with {{api_key}}
apiKey: queryapikey query param
oauth2oauth2 (note: requires manual token setup)

Apply auth at collection level if all endpoints share the same scheme. Override at request level for exceptions.


Step 5 — Build Collection JSON

Use the standard v2.1 structure (same schema as postman-collection-generator skill).

Key differences for spec-converted collections:

  • Always group by tags into folders
  • Include description field on each request from operationId + summary + description
  • Add saved example responses where responses are defined in the spec
json
"response": [
  {
    "name": "200 OK",
    "status": "OK",
    "code": 200,
    "header": [{ "key": "Content-Type", "value": "application/json" }],
    "body": "{ \"id\": 1, \"name\": \"example\" }",
    "originalRequest": { <copy of the request> }
  }
]

Step 6 — Environment File

Extract all variables into a companion environment:

  • base_url from servers[0].url or host + basePath
  • token, api_key, username, password as empty placeholders
  • Any server variables from servers[0].variables

Step 7 — Output

  1. collection.json — Full Postman Collection v2.1
  2. environment.json — Matching environment file
  3. Conversion summary: number of endpoints converted, folders created, auth type detected, any fields skipped or approximated
  4. Import instructions

Show full SKILL.md (257 more words)Show less

Edge Cases

  • $ref chains: Resolve all $ref pointers inline before mapping
  • allOf / oneOf / anyOf: Use the first/primary schema for body generation; note alternatives in description
  • Path parameters: Convert {param} to :param in URL path AND add to variable array in url object
  • Multiple content types: Prefer application/json; note others in request description
  • No operationId: Generate name from METHOD /path (e.g., GET /users/{id} → Get User by ID)

Quality Checklist

  • Every paths entry produces at least one request
  • Path params use :param format in Postman URL
  • All $ref resolved — no raw $ref strings in output
  • Auth tokens are {{variables}}, never hardcoded
  • JSON output is valid and importable

After Completing the API Design

Once the API design output is delivered, ask the user:

"Would you like me to generate API documentation for this design? (yes/no)"

If the user says yes:

  • Check if the API Documentation skill is available in the installed skills list
  • If the skill is available:
    • Read and follow the instructions in the API Documentation skill
    • Use the API design output above as the input
  • If the skill is NOT available:
    • Inform the user: "It looks like the API Documentation skill isn't installed. You can install it and re-run.

If the user says no:

  • End the task here

Limitations

  • Use this skill only when the task clearly matches its upstream source and local project context.
  • Verify commands, generated code, dependencies, credentials, and external service behavior before applying changes.
  • Do not treat examples as a substitute for environment-specific tests, security review, or user approval for destructive or costly actions.

© sickn33, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in skills/postman-openapi-converter of sickn33/agentic-awesome-skills.

Open the folder on GitHubat commit 680176d

Used in 1 other repository

We found 5 copies of this SKILL.md (exact, near-identical or edited) in other folders, from 1 other GitHub owner. This page covers the copy in sickn33/agentic-awesome-skills, which our catalogue first saw on October 7, 2026.

Compare with similar skills

Postman Openapi Converter next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Postman Openapi Converter compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Postman Openapi Converter this skillsickn33/agentic-awesome-skills47k1 repos~1.5kAutomated safety check: PassMIT
Use Yaakmountain-loop/yaak19k—~1.9kAutomated safety check: PassMIT
Dingtalk MiscDingTalk-Real-AI/dingtalk-workspace-cli3.2k—~2.6kAutomated safety check: PassApache-2.0
ToolJet Marketplace Plugin BuilderToolJet/ToolJet41k—~2.1kAutomated safety check: PassAGPL-3.0
API Featuregocronx-team/gocron808—~1.2kAutomated safety check: PassMIT
Dotnet Webapidotnet/skills5.6k2 repos~5.5kAutomated safety check: PassMIT

Similar skills

  • Use Yaak

    mountain-loop/yaak

    A skill your agent uses when the user mentions Yaak, a Yaak workspace, or the yaak command, or asks to call, hit, or smoke test HTTP/REST endpoints, save or organize API requests for reuse or manual…

    19k GitHub stars~1.9k tokensUpdated 2 days ago
    Backend & APIsAuto-check passed
  • Dingtalk Misc

    DingTalk-Real-AI/dingtalk-workspace-cli

    钉钉独立白板(白板文件)的创建、绘图、保存和修改;文档内嵌白板仅在已有承载文档 nodeId 和 partId 时提供图形内容读写(dws whiteboard)。两类目标相互独立,不互相推断或切换;文档内白板卡片容器不属于本 skill。长尾产品集合技能,覆盖低频钉钉产品:OA审批查询与处理/法务智能合同/考勤/直播/DING紧急消息/开放平台应用与MCP开发/Agoal目标管理/日志日报周报…

    3.2k GitHub stars~2.6k tokensUpdated today
    Backend & APIsAuto-check passed
  • Turns an API description, such as an OpenAPI file or a Postman collection, into a connector plugin for ToolJet's marketplace and checks it with the repo's validator.

    41k GitHub stars~2.1k tokensUpdated today
    Backend & APIsAuto-check passed
  • API Feature

    gocronx-team/gocron

    Implement or review an end-to-end gocron HTTP API change. An agent skill from gocronx-team/gocron.

    808 GitHub stars~1.2k tokensUpdated 6 days ago
    Backend & APIsAuto-check passed
  • Dotnet Webapi

    dotnet/skills

    Official

    Guides creation and modification of ASP.NET Core Web API endpoints with correct HTTP semantics, OpenAPI metadata, and error handling.

    5.6k GitHub starsUsed in 2 repos~5.5k tokens
    Backend & APIsAuto-check passed
  • API Doc Standards

    revfactory/harness-100

    API document writing tablelevel and pattern library. An agent skill from revfactory/harness-100.

    1.3k GitHub stars~915 tokensUpdated 6 mo ago
    Backend & APIsAuto-check passed

More from sickn33/agentic-awesome-skills

All 1,493 skills in this repo
  • Liuguang Banlan UI

    sickn33/agentic-awesome-skills

    Implements an interface in one of two named color modes, iridescent white or colorful black, from a parameterized starter that reports measured color intensity.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • User Thoughts Memory

    sickn33/agentic-awesome-skills

    Saves a user's project decisions, rules and preferences into a project-local mdbase so later sessions and other agents can recover the intent.

    47k GitHub starsUsed in 1 repo~2.5k tokens
    Auto-check passed
  • Using LWC Memory and Graphs

    sickn33/agentic-awesome-skills

    Keeps project decisions, research and verified results available across coding-agent sessions through LWC memory, a document Wiki graph and a CodeGraph code index.

    47k GitHub starsUsed in 1 repo~2k tokens
    Auto-check passed
  • Find Complementary Founders

    sickn33/agentic-awesome-skills

    Guides an agent through assessing its own owner for cofounder fit, publishing an approved profile, and ranking complementary profiles other agents published for their owners.

    47k GitHub starsUsed in 1 repo~4.8k tokens
    Auto-check passed
  • Whatsapp Cloud API

    sickn33/agentic-awesome-skills

    Integracao com WhatsApp Business Cloud API (Meta). An agent skill from sickn33/agentic-awesome-skills.

    47k GitHub starsUsed in 2 repos~4.5k tokens
    Auto-check passed
  • Cline Pilot

    sickn33/agentic-awesome-skills

    Acts as a proxy for the Cline CLI, dispatching coding tasks one at a time, monitoring runs by hard evidence, relaying decisions to you and learning per-project preferences.

    47k GitHub starsUsed in 1 repo~4.6k tokens
    Auto-check passed

Works with

Categories

Questions about Postman Openapi Converter

What does Postman Openapi Converter do?

Convert OpenAPI 3.x or Swagger 2.0 specs (YAML or JSON) into complete, import-ready Postman Collection v2.1 JSON files. Postman Openapi Converter is an agent skill from sickn33/agentic-awesome-skills.1 JSON files.

When should I use Postman Openapi Converter?

Postman Openapi Converter fits situations like: tasks that involve OpenAPI specifications; tasks that involve API testing.

How do I install Postman Openapi Converter in Claude Code?

Run `npx skills add sickn33/agentic-awesome-skills --skill postman-openapi-converter -a claude-code`. Or copy the skill folder (skills/postman-openapi-converter in sickn33/agentic-awesome-skills) into .claude/skills/postman-openapi-converter in your project. Claude Code loads it when a task matches its description.

How do I install Postman Openapi Converter in Codex?

Run `npx skills add sickn33/agentic-awesome-skills --skill postman-openapi-converter -a codex`. Or copy the skill folder (skills/postman-openapi-converter in sickn33/agentic-awesome-skills) into .agents/skills/postman-openapi-converter in your project. Codex loads it when a task matches its description.

Can I use Postman Openapi Converter in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add sickn33/agentic-awesome-skills --skill postman-openapi-converter -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/postman-openapi-converter, .gemini/skills/postman-openapi-converter, .github/skills/postman-openapi-converter and .opencode/skills/postman-openapi-converter in your project.

What does Postman Openapi Converter need to run?

SKILL.md names no scripts, command-line tools or credentials: Postman Openapi Converter is instructions for the agent only.

Does Postman Openapi Converter access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Postman Openapi Converter safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Postman Openapi Converter use?

Postman Openapi Converter is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Postman Openapi Converter use?

About 1.5k tokens (SKILL.md is roughly 6k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Postman Openapi Converter?

Skills that share tags, products or a category with Postman Openapi Converter: Use Yaak (mountain-loop/yaak, 19k stars), Dingtalk Misc (DingTalk-Real-AI/dingtalk-workspace-cli, 3.2k stars), ToolJet Marketplace Plugin Builder (ToolJet/ToolJet, 41k stars) and API Feature (gocronx-team/gocron, 808 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Postman Openapi Converter?

sickn33 (a GitHub user) maintains it in sickn33/agentic-awesome-skills, which has 47,379 GitHub stars. The repository holds 1,493 skills in this directory. The repository was last updated on October 9, 2026.

Source: sickn33/agentic-awesome-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.