# API gateway openapi spec authoring

> API gateway openapi spec authoring is an open-source agent skill for developer tools. Writes, migrates, and fixes OpenAPI specs for Google Cloud API Gateway. It is available on Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose.

- **Kind:** Skill
- **Pricing:** Open source
- **Platforms:** Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf, Goose
- **Website:** https://github.com/google/skills/tree/main/skills/cloud/api-gateway-openapi-spec-authoring
- **Repository:** https://github.com/google/skills
- **GitHub stars:** 24,379
- **License:** Apache-2.0
- **Skill name:** api-gateway-openapi-spec-authoring
- **Collection:** https://github.com/google/skills
- **Categories:** developer tools
- **Listing updated:** 2026-11-17

## About

Writes, migrates, and fixes OpenAPI specs for Google Cloud API Gateway. Use when converting an OpenAPI 2.0 (Swagger) spec to OpenAPI 3.x, writing a new OpenAPI 3.x spec, or fixing a failed "gcloud api-gateway api-configs create", such as "extension is only supported in OpenAPI 2.x". Also use when quotas set with x-google-quota are never enforced, or when a backend receives path parameters as query parameters. Don't use for adding or debugging MCP tools (use api-gateway-mcp-server), backend lockdown or HTTP 429 tuning (use api-gateway-backend-security-and-rate-limiting), Cloud Endpoints, Apigee, or GKE Gateway API.

## When your agent uses it

> Writes, migrates, and fixes OpenAPI specs for Google Cloud API Gateway. Use when converting an OpenAPI 2.0 (Swagger) spec to OpenAPI 3.x, writing a new OpenAPI 3.x spec, or fixing a failed "gcloud api-gateway api-configs create", such as "extension is only supported in OpenAPI 2.x". Also use when quotas set with x-google-quota are never enforced, or when a backend receives path parameters as query parameters. Don't use for adding or debugging MCP tools (use api-gateway-mcp-server), backend lockdown or HTTP 429 tuning (use api-gateway-backend-security-and-rate-limiting), Cloud Endpoints, Apigee, or GKE Gateway API.

## What it can access

From a static check of the files on GitHub; nothing was run.

- [Runs Python scripts](https://github.com/google/skills/tree/HEAD/skills/cloud/api-gateway-openapi-spec-authoring)
- [Network calls found in its scripts](https://github.com/google/skills/tree/HEAD/skills/cloud/api-gateway-openapi-spec-authoring)
- [License: Apache-2.0](https://github.com/google/skills/tree/HEAD/skills/cloud/api-gateway-openapi-spec-authoring)

## Install

### Claude Code

Copy the skill folder to `~/.claude/skills/api-gateway-openapi-spec-authoring` to use it in all your projects:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/google/skills.git "$tmp" &&
mkdir -p ~/.claude/skills &&
rm -rf ~/.claude/skills/api-gateway-openapi-spec-authoring &&
cp -R "$tmp/skills/cloud/api-gateway-openapi-spec-authoring" ~/.claude/skills/api-gateway-openapi-spec-authoring &&
rm -rf "$tmp"
```

For one project only, put the folder in `.claude/skills/api-gateway-openapi-spec-authoring` inside it instead.

### Codex

Copy the skill folder to `~/.agents/skills/api-gateway-openapi-spec-authoring` to use it in every repository:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/google/skills.git "$tmp" &&
mkdir -p ~/.agents/skills &&
rm -rf ~/.agents/skills/api-gateway-openapi-spec-authoring &&
cp -R "$tmp/skills/cloud/api-gateway-openapi-spec-authoring" ~/.agents/skills/api-gateway-openapi-spec-authoring &&
rm -rf "$tmp"
```

For one repository only, put the folder in `.agents/skills/api-gateway-openapi-spec-authoring` inside it instead.

### Cursor

Copy the skill folder to `~/.cursor/skills/api-gateway-openapi-spec-authoring` to use it in every project:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/google/skills.git "$tmp" &&
mkdir -p ~/.cursor/skills &&
rm -rf ~/.cursor/skills/api-gateway-openapi-spec-authoring &&
cp -R "$tmp/skills/cloud/api-gateway-openapi-spec-authoring" ~/.cursor/skills/api-gateway-openapi-spec-authoring &&
rm -rf "$tmp"
```

For one project only, put the folder in `.cursor/skills/api-gateway-openapi-spec-authoring` inside it instead.

### Gemini CLI

Run in a terminal (add `--scope workspace` to install it for the current workspace only):

```sh
gemini skills install https://github.com/google/skills.git --path skills/cloud/api-gateway-openapi-spec-authoring
```

Or copy the folder to `~/.gemini/skills/api-gateway-openapi-spec-authoring` yourself.

### VS Code

For GitHub Copilot in VS Code, copy the skill folder to `~/.copilot/skills/api-gateway-openapi-spec-authoring`:

```sh
tmp=$(mktemp -d) &&
git clone --depth 1 https://github.com/google/skills.git "$tmp" &&
mkdir -p ~/.copilot/skills &&
rm -rf ~/.copilot/skills/api-gateway-openapi-spec-authoring &&
cp -R "$tmp/skills/cloud/api-gateway-openapi-spec-authoring" ~/.copilot/skills/api-gateway-openapi-spec-authoring &&
rm -rf "$tmp"
```

For one project only, put the folder in `.github/skills/api-gateway-openapi-spec-authoring` inside it instead.

### Other agents

Get the folder:

```sh
git clone --depth 1 https://github.com/google/skills.git
```

Then copy `skills/skills/cloud/api-gateway-openapi-spec-authoring` into your agent's skills folder as `api-gateway-openapi-spec-authoring`. Agents that support SKILL.md read one folder per skill.

## FAQ

### How do I install API gateway openapi spec authoring in Claude Code?

Copy the skill folder from GitHub to ~/.claude/skills/api-gateway-openapi-spec-authoring to use it in all your projects, or to .claude/skills/api-gateway-openapi-spec-authoring in one project.

### Does API gateway openapi spec authoring run scripts?

Yes. It runs Python scripts. Its scripts contain network calls. This comes from a static check of the files on GitHub; nothing was run. Read the files before you install it.

### Which AI agents can use API gateway openapi spec authoring?

Claude Code, Codex, Cursor, Gemini CLI, GitHub Copilot, Windsurf and Goose. Each reads skills in the SKILL.md format from its own folder; the install steps on this page list them.

### What are the best alternatives to API gateway openapi spec authoring?

The closest alternatives to API gateway openapi spec authoring are Rea changelog update, Code review, Gem devops guidelines, PR screenshots and Make repo contribution.

## Alternatives

- [Rea changelog update](https://ai-powered.com/skills/rea-changelog-update): Rea changelog update is an open-source agent skill for developer tools.
- [Code review](https://ai-powered.com/skills/code-review-mattpocock): Code review is an open-source agent skill for developer tools.
- [Gem devops guidelines](https://ai-powered.com/skills/gem-devops-guidelines): Gem devops guidelines is an open-source agent skill for cloud and infrastructure.
- [PR screenshots](https://ai-powered.com/skills/pr-screenshots): PR screenshots is an open-source agent skill for developer tools.
- [Make repo contribution](https://ai-powered.com/skills/make-repo-contribution): Make repo contribution is an open-source agent skill for developer tools.
- [Create github issues for unmet specification requirements](https://ai-powered.com/skills/create-github-issues-for-unmet-specification-requirements): Create github issues for unmet specification requirements is an open-source agent skill for developer tools.
- [Github actions hardening](https://ai-powered.com/skills/github-actions-hardening): Github actions hardening is an open-source agent skill for developer tools.
- [Github codespaces efficiency](https://ai-powered.com/skills/github-codespaces-efficiency): Github codespaces efficiency is an open-source agent skill for developer tools.

---
Source: https://ai-powered.com/skills/api-gateway-openapi-spec-authoring
