apic-openapi-operation-selector

Installation
SKILL.md

OpenAPI Operation Selector

Use this skill when you need to inspect an OpenAPI or Swagger file, derive every unique path and HTTP method combination, present them to the user as numbered selectable options, collect the user's numeric choices, and only then print the chosen values as a JSON object mapping paths to their HTTP methods.

Inputs

  • Path to an OpenAPI file in JSON, YAML, or YML format

Selection behavior

  • The skill must not rely on terminal-only interactive prompts as the primary selection UX
  • The script should first produce a structured list of numbered options
  • The agent MUST present those options to the user in chat and WAIT for the user's response
  • The user MUST reply with a comma-separated list of option numbers such as 1,3,4
  • CRITICAL: The agent MUST NOT use --select-indexes until the user has explicitly provided the indexes to select
  • Only after the user has chosen numbers should the script be run again to produce the selected array

Selection label rules

Installs
2
GitHub Stars
4
First Seen
Jul 1, 2026
apic-openapi-operation-selector — ibm-apiconnect/apic-mcp-server