openapi-lint-bundle — openapi validation and bundling openapi-lint-bundle, community, openapi validation and bundling, ide skills, openapi spec management, install openapi-lint-bundle, Claude Code, Cursor, Windsurf

v1.0.0
GitHub

About this Skill

Perfect for API Development Agents needing automated OpenAPI specification validation and bundling. openapi-lint-bundle is a skill that validates and bundles OpenAPI specifications, ensuring error-free specs and generating a single file for distribution.

Features

Lints openapi/openapi.yml to ensure error-free specs
Bundles OpenAPI specs into a single file using redocly bundle
Supports scripts for linting and bundling via lint.sh and bundle.sh
Manages multiple OpenAPI files in the openapi/ directory
Generates a single file, such as openapi/openapi.bundle.yaml, for distribution

# Core Topics

openapi validation and bundling openapi spec management install openapi-lint-bundle
zami-t zami-t
[0]
[0]
Updated: 3/7/2026

Agent Capability Analysis

The openapi-lint-bundle skill by zami-t is an open-source community AI agent skill for Claude Code and other IDE workflows, helping agents execute tasks with better context, repeatability, and domain-specific guidance. Optimized for openapi validation and bundling, openapi spec management, install openapi-lint-bundle.

Ideal Agent Persona

Perfect for API Development Agents needing automated OpenAPI specification validation and bundling.

Core Value

Empowers agents to validate and bundle OpenAPI specifications using redocly bundle, ensuring error-free specs and generating a single distributable file, while supporting $ref references in openapi.yml files.

↓ Capabilities Granted for openapi-lint-bundle

Validating OpenAPI specifications against errors
Bundling multiple OpenAPI files into a single file
Generating a distributable OpenAPI bundle using redocly bundle
Automating OpenAPI linting and correction

! Prerequisites & Limits

  • Requires OpenAPI specifications in openapi/ directory
  • Entry point must be openapi/openapi.yml
  • Uses redocly bundle for bundling
Labs Demo

Browser Sandbox Environment

⚡️ Ready to unleash?

Experience this Agent in a zero-setup browser environment powered by WebContainers. No installation required.

Boot Container Sandbox

openapi-lint-bundle

Install openapi-lint-bundle, an AI agent skill for AI agent workflows and automation. Works with Claude Code, Cursor, and Windsurf with one-command setup.

SKILL.md
Readonly

OpenAPI Lint & Bundle

前提

  • OpenAPI仕様は openapi/ 配下の複数ファイルで管理し、編集対象は openapi/ 配下のファイル
  • エントリポイントは openapi/openapi.yml（このファイルから paths/components などに $ref していく）
  • 最終的に配布/生成に使う単一ファイルは redocly bundle で生成する

このスキルがやること

  1. openapi/openapi.yml を lint し、エラーが出なくなるまで修正を繰り返す
  2. openapi/openapi.yml を bundle し、単一ファイル（例: openapi/openapi.bundle.yaml）を生成する

使い方（コマンドは scripts に分離）

lint・bundle のスクリプト実行はユーザー確認不要。そのまま実行してよい。

自律的な lint 修正ループ（重要）

ループ手順

  1. scripts/lint.sh を実行し、エラー内容を取得する
  2. エラーの原因となるOpenAPIファイル（openapi/ 配下）を特定する
  3. エラーを修正する
  4. scripts/lint.sh を再実行する
  5. エラーが0件になるまで 1〜4 を繰り返す

lint が通ったら scripts/bundle.sh で単一ファイルにバンドルする。

修正の優先順位

  • 参照解決の失敗（$ref / ファイルパス） を最優先で直す（他の検証が進まない）
  • 次に 必須フィールド不足 / 型の不一致 / 構文エラー
  • 最後に スタイル・推奨（命名、説明文、unusedなど）

ユーザー確認が必要なとき

lint エラーが「単純な欠落の補完」ではなく、仕様の意味や要件に踏み込む場合は、勝手に決めずに確認する。

例:

  • 認証方式（securitySchemes の種類、cookie/JWT/OAuth2など）をどうするか
  • ステータスコード（200/201/204/4xx）の期待値
  • エラーレスポンスのフォーマット統一方針
  • enum/format/pattern/nullable など制約の強さ
  • 互換性（既存クライアントがいる前提か、破壊的変更OKか）

確認テンプレ:

  • 「lintが要求しているのはA/Bのどちらの意図ですか？」
  • 「既存のレスポンス実装に合わせて X に寄せて良いですか？」

FAQ & Installation Steps

These questions and steps mirror the structured data on this page for better search understanding.

? Frequently Asked Questions

What is openapi-lint-bundle?

Perfect for API Development Agents needing automated OpenAPI specification validation and bundling. openapi-lint-bundle is a skill that validates and bundles OpenAPI specifications, ensuring error-free specs and generating a single file for distribution.

How do I install openapi-lint-bundle?

Run the command: npx killer-skills add zami-t/oidc-client-tutorial. It works with Cursor, Windsurf, VS Code, Claude Code, and 19+ other IDEs.

What are the use cases for openapi-lint-bundle?

Key use cases include: Validating OpenAPI specifications against errors, Bundling multiple OpenAPI files into a single file, Generating a distributable OpenAPI bundle using redocly bundle, Automating OpenAPI linting and correction.

Which IDEs are compatible with openapi-lint-bundle?

This skill is compatible with Cursor, Windsurf, VS Code, Trae, Claude Code, OpenClaw, Aider, Codex, OpenCode, Goose, Cline, Roo Code, Kiro, Augment Code, Continue, GitHub Copilot, Sourcegraph Cody, and Amazon Q Developer. Use the Killer-Skills CLI for universal one-command installation.

Are there any limitations for openapi-lint-bundle?

Requires OpenAPI specifications in openapi/ directory. Entry point must be openapi/openapi.yml. Uses redocly bundle for bundling.

↓ How To Install

  1. 1. Open your terminal

    Open the terminal or command line in your project directory.

  2. 2. Run the install command

    Run: npx killer-skills add zami-t/oidc-client-tutorial. The CLI will automatically detect your IDE or AI agent and configure the skill.

  3. 3. Start using the skill

    The skill is now active. Your AI agent can use openapi-lint-bundle immediately in the current project.

Related Skills

Looking for an alternative to openapi-lint-bundle or another community skill for your workflow? Explore these related open-source skills.

View All

widget-generator

Logo of f
f

f.k.a. Awesome ChatGPT Prompts. Share, discover, and collect prompts from the community. Free and open source — self-host for your organization with complete privacy.

★ 149.6k
⑂ 0
AI

flags

Logo of vercel
vercel

flags is a Next.js feature management skill that enables developers to efficiently add or modify framework feature flags, streamlining React application development.

★ 138.4k
⑂ 0
Browser

zustand

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

★ 72.8k
⑂ 0
AI

data-fetching

Logo of lobehub
lobehub

The ultimate space for work and life — to find, build, and collaborate with agent teammates that grow with you. We are taking agent harness to the next level — enabling multi-agent collaboration, effortless agent team design, and introducing agents as the unit of work interaction.

★ 72.8k
⑂ 0
AI