There are many (https://openapi.tools/#description-validators) validators available to assure that an OpenAPI spec is valid.

In order to prevent publishing an invalid spec, I suggest using these internally.

See https://ideas.circleci.com/api-feature-requests/p/fix-spec-violations-in-insightsproject-slugworkflows-path-in-openapi-spec for an example of errors in your spec.