API Caller Skill

Generic skill to call any REST API dynamically. Can work with OpenAPI specs or direct endpoint calls.

Capabilities

• Call any REST API endpoint (GET, POST, PUT, DELETE)
• Parse OpenAPI/Swagger specs to discover endpoints
• Handle common authentication (API keys, Bearer tokens)
• JSON request/response handling

Instructions

1. Read this SKILL.md to choose the direct-call or OpenAPI workflow.
2. Use scripts/parse_openapi.py first when the user gives an OpenAPI or Swagger spec.
3. Use scripts/call_api.py for the actual HTTP request.
4. Return the request result and any recoverable error details to the user.

Scripts

scripts/parse_openapi.py

Use this first when given an API spec URL. Parses an OpenAPI/Swagger spec and returns available operations with parameters. Run commands from the skill base directory; script paths are relative to this SKILL.md file.

Usage:

python scripts/parse_openapi.py <spec_url> [filter_path]

Arguments:

• <spec_url> - URL to the OpenAPI spec (required)
• [filter_path] - Optional: filter operations by path substring

Example:

python scripts/parse_openapi.py "https://api.example.com/openapi.json"

Returns: API name, base URL, and list of operations with their parameters, request body schema, etc.

scripts/call_api.py

Call a REST API endpoint directly or using an OpenAPI spec. Run commands from the skill base directory; script paths are relative to this SKILL.md file.

Usage:

python scripts/call_api.py --url <endpoint_url> [options]