---
stable_id: skills/skills-sh-hairyf-skills-openapi-specification-v2
type: skills
title: skills-sh-hairyf-skills-openapi-specification-v2
summary: >-
  ---

  name: core-format-and-structure

  description: OpenAPI/Swagger 2.0 document format, file structure, and data
  types

  ---

  # Format and Structure (Swagger 2.0)

  Swagger 2.0 specs are JSON or YAML. Field names are **case sensitive**. The
  spec uses fixed fields (declared names) and patterned fields (regex for names,
  e.g. path keys, `^x-` extensions).

  ## File structure

  - Single file by default; convention is `swagger.json`.

  - Parts can be split via `$ref` (JSON Schema style). Only canonical
  dereferencing is supported for `$ref`.

  ## Data types
tags:
  - skills-sh
  - skills-sh-all-time
source_url: https://raw.githubusercontent.com/hairyf/skills/HEAD/skills/openapi-specification-v2/references/core-format-and-structure.md
license: ""
upstream_ref: https://skills.sh/hairyf/skills/openapi-specification-v2
github_stars: null
github_forks: null
github_is_organization: null
retrieved_at: 2026-06-11T08:32:00.927Z
content_sha256: 0f8d6b2e4e8d3b7b0c559cec5212e80600baf92b6cbca6c9156b71784ebe61f0
---
