openapi-extraction-guide

Turn stable API operations into stable MCP tools with clear names and reliable schemas.

Content Preview
# OpenAPI Extraction Guide

## Goal

Turn stable API operations into stable MCP tools with clear names and reliable schemas.

## Extraction Rules

1. Prefer `operationId` as tool name.
2. Fallback naming: `<method>_<path>` sanitized to snake_case.
3. Pull `summary` for tool description; fallback to `description`.
4. Merge path/query parameters into `inputSchema.properties`.
5. Merge `application/json` request-body object properties when available.
6. Preserve required fields from both parameters
How to Use

Recommended: Install to project (local)

mkdir -p .claude/skills
curl -o .claude/skills/openapi-extraction-guide.md \
  https://raw.githubusercontent.com/alirezarezvani/claude-skills/main/engineering/mcp-server-builder/references/openapi-extraction-guide.md

Skill is scoped to this project only. Add .claude/skills/ to your .gitignoreif you don't want to commit it.

Alternative: Clone full repo

git clone https://github.com/alirezarezvani/claude-skills

Then reference at engineering/mcp-server-builder/references/openapi-extraction-guide.md

Related Skills