Stats
Actions
Tags
From adk-tools
Use this skill to expose a REST API as ADK 2.0 tools by pointing at its OpenAPI / Swagger spec. Triggers on: "ADK OpenAPI tool", "Swagger to ADK", "REST API as ADK tools", "ADK from OpenAPI spec", "expose REST endpoints to agent", "ADK OpenAPIToolset", "auto-generate ADK tools from spec". Generates an OpenAPIToolset bound to a spec file or URL — every operation becomes a callable tool with auto-derived parameters and types.
How this skill is triggered — by the user, by Claude, or both
Slash command
/adk-tools:openapi-tool-generatorThe summary Claude sees in its skill listing — used to decide when to auto-load this skill
Turn a REST API's OpenAPI 3.x spec into ADK 2.0 tools automatically. Each spec operation becomes one tool.
Turn a REST API's OpenAPI 3.x spec into ADK 2.0 tools automatically. Each spec operation becomes one tool.
from google.adk.agents import LlmAgent
from google.adk.tools.openapi_tool import OpenAPIToolset
from google.adk.tools.openapi_tool.auth import AuthScheme, AuthCredential
petstore_toolset = OpenAPIToolset(
spec_path="./petstore.openapi.yaml", # or spec_url=
auth_scheme=AuthScheme(type="apiKey", in_="header", name="X-API-Key"),
auth_credential=AuthCredential(api_key_env="PETSTORE_API_KEY"),
)
root_agent = LlmAgent(
name="pet_store_agent",
model="gemini-2.5-flash",
instruction="Help the user manage pets in the store inventory.",
tools=[petstore_toolset],
)
toolset = OpenAPIToolset(
spec_url="https://api.example.com/openapi.json",
)
toolset = OpenAPIToolset(
spec_path="./petstore.openapi.yaml",
operation_filter=["listPets", "getPetById", "addPet"],
)
| Scheme | Config |
|---|---|
| API Key | type="apiKey", in header/query/cookie |
| Bearer | type="http", scheme="bearer" |
| OAuth2 | type="oauth2", with flows config |
| Basic | type="http", scheme="basic" |
| OpenAPI | ADK tool |
|---|---|
operationId | tool name |
summary | tool description (first line) |
description | tool description (full) |
| Path/query/header params | tool parameters |
requestBody schema | tool body parameter |
responses[200] schema | tool return type hint |
npx @apidevtools/swagger-cli validate ./petstore.openapi.yamloperationId (else ADK auto-derives — review for collisions)npx claudepluginhub healthcare-ai-consulting-llc/adk-2-toolkit --plugin adk-toolsGuides creation, editing, and verification of skills for AI coding agents using test-driven development with subagent scenarios. Use when authoring or debugging skills.