Does this work with Swagger or just OpenAPI?

While named for OpenAPI, it supports modern specifications that are compatible with Redocly's linting and bundling engine.

When will Claude ask for user confirmation?

Claude will ask for confirmation if an error requires a design decision, such as choosing an authentication method, changing response codes, or modifying breaking compatibility.

What tools does this skill use for linting?

This skill is designed to interface with Redocly through local scripts to perform standardized linting and bundling of OpenAPI 3.x specifications.

Can it fix OpenAPI errors automatically?

Yes, it features an autonomous loop that identifies linting errors in the openapi/ directory and attempts to fix them iteratively until the specification is valid.

Does it support multi-file specifications?

Yes, it is optimized for projects that split paths, components, and schemas into separate files, using an entry point like openapi.yml.

OpenAPI Lint & Bundle

Name: OpenAPI Lint & Bundle
Author: zami-t

byzami-t

0•

API開発

Validates and bundles multi-file OpenAPI specifications into a single, production-ready document.

This skill automates the management of complex OpenAPI specifications by providing an autonomous linting and bundling workflow. It manages definitions stored across multiple files in the openapi/ directory, using Redocly to identify schema violations or reference errors. The skill features an iterative 'fix-and-check' loop that resolves validation issues automatically, prioritizing reference resolution and syntax before moving to style recommendations. Once the specification is error-free, it generates a single bundled YAML file suitable for documentation hosting, SDK generation, or deployment.

主な機能

01Context-aware decision making for API architectural changes

02Intelligent prioritization of reference resolution and broken file paths

03Seamless execution of local lint and bundle shell scripts

040 GitHub stars

05Autonomous linting loop that fixes schema errors until validation passes

06Redocly-powered bundling of fragmented OpenAPI definitions

ユースケース

01Generating unified API specification files for client-side SDK generation

02Automating the cleanup of OpenAPI schema violations during development

03Managing large-scale API documentation split across multiple YAML files

What are Skills?·How to Install

Install with 🐟 Skill.Fish

npx skillfish add zami-t/oidc-client-tutorial openapi-lint-bundle

For use in Claude.ai and ChatGPT

Download Skill