openapi-format

Follow this skill when a user asks to transform an OpenAPI document with the openapi-format CLI.

Core workflow

1. Identify the target outcome first.

• Determine exactly what should change: order, filtering, casing, generation, overlay, conversion, rename, output format, split.
• Determine input source (local file, remote URL, or overlay extends fallback).

2. Choose command shape.

• Prefer a single command with explicit input/output unless the user asks for stdout.
• Use --configFile for reusable workflows.
• Use .openapiformatrc for project defaults.

3. Keep config minimal.

• Start from defaults.
• Add only keys required for requested behavior.
• Avoid writing exhaustive config unless requested.