mcpField
K
kubb

kubb

github.com/fandhe-aiDevelopment497 installsUpdated 4d ago
Repository

About kubb

A documentation reference skill for Kubb v5. Task-based navigation helps developers find configuration, plugin, CLI, and integration guidance for workflows involving OpenAPI and code generation.

Key features

  1. 01Covers Kubb v5 core and extension documentation
  2. 02Indexes plugin, adapter, and parser references
  3. 03Provides CLI command and configuration guidance
  4. 04Includes AI and MCP integration topics

Use cases

  1. 01Generate TypeScript clients or Zod schemas
  2. 02Find OpenAPI parsing and plugin configuration guidance
  3. 03Review Kubb CLI or MCP integration

MCP support

The documentation covers the @kubb/mcp plugin, MCP server integration, and using MCP servers from AI assistants.

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/fandhe-ai/agent-reference-skills --skill kubb

After installing, type/kubbin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/adapters/
adapter-oas.md
README.md
references/ai/
claude-desktop.md
claude.md
context7.md
llmstxt.md
mcp.md
README.md
references/commands/
add.md
generate.md
init.md
list.md
mcp.md
README.md
studio.md
update.md
validate.md
references/examples/
advanced.md
axios.md
client.md
cypress.md
faker.md
fetch.md
generators.md
mcp.md
msw.md
react-query.md
README.md
sdk.md
simple.md

Details

From the project README

Kubb リファレンス

Kubb(kubb.dev)の /docs/5.x と /extensions/kubb-labs/* のドキュメントを網羅したスキル。 ユーザーのタスクに応じて適切な README.md を読み、そこから個別ファイルへ辿ること。

対象 Kubb v5 stable — kubb / @kubb/core / adapter-oas / parser-ts / parser-md / plugin-barrel / unplugin-kubb / @kubb/mcp 5.11.0(kubb-labs/kubb タグ [email protected])。プラグインは kubb-labs/plugins からパッケージ単位で pin(plugin-ts 5.0.14、client 5.5.15、fetch 5.6.5、axios 5.6.5、zod 5.4.12、faker 5.1.9、msw 5.1.3、react-query 5.5.3、vue-query 5.5.3、swr 5.4.3、mcp 5.2.3、cypress 5.0.14、redoc 5.0.12)。取得日 2026-10-16。plugin-solid-query / plugin-svelte-query / plugin-oas は v4 系(4.39.3)のままで v5 リリースなし。

ディレクトリ構成

skills/kubb/
  SKILL.md
  references/
    getting-started/
      README.md
      installation.md
      introduction.md
      quick-start.md
      telemetry.md
      troubleshooting.md
    plugins/
      README.md
      overview.md
      core.md
      plugin-axios.md
      plugin-barrel.md
      plugin-client.md
      plugin-cypress.md
      plugin-faker.md
      plugin-fetch.md
      plugin-mcp.md
      plugin-msw.md
      plugin-react-query.md
      plugin-redoc.md
      plugin-swr.md
      plugin-ts.md
      plugin-vue-query.md
      plugin-zod.md
    plugin-guides/            # 27 ページ(プラグイン別 how-to)
      README.md
      fetch-*.md              # authentication / base-url / calling-operations / error-handling / interceptors / serialization / server-sent-events / transport
      axios-*.md              # 同上 8 ページ
      client-*.md             # authentication / calling-operations / validate-requests-and-responses / write-your-client
      react-query-calling-operations.md
      vue-query-calling-operations.md
      swr-calling-operations.md
      msw-mock-api.md
      mcp-server.md
      ts-customization.md
      zod-customization.md
    adapters/
      README.md
      adapter-oas.md
    parsers/
      README.md
      parser-md.md
      parser-ts.md
    kit/                      # 13 ページ(kubb/kit API 概念別)
      README.md
      adapters.md
      ast.md
      engine.md
      extension-docs.md
      extensions.md
      generators.md
      hooks.md
      manifest.md
      parsers.md
      plugins.md
      resolvers.md
      storage.md
      testing.md
    commands/                 # CLI 8 コマンド
      README.md
      init.md
      generate.md
      validate.md
      mcp.md
      studio.md
      add.md
      update.md
      list.md
    integrations/
      README.md
      overview.md
      studio.md
      ci.md
      github-actions.md
      gitlab.md
    reference/
      README.md
      configuration.md
      plugin-options.md
      diagnostics.md
      kit-api.md
      jsx.md
      serialization.md
      registry.md
      github-actions.md
    helpers/
      README.md
      cli.md
      mcp.md
      unplugin.md
    ai/
      README.md
      claude.md
      claude-desktop.md
      context7.md
      llmstxt.md
      mcp.md
    examples/
      README.md
      simple.md
      typescript.md
      client.md
      axios.md
      fetch.md
      sdk.md
      cypress.md
      react-query.md
      vue-query.md
      svelte-query.md    # v4 専用(v5 で削除)
      solid-query.md     # v4 専用(v5 で削除)
      swr.md
      zod.md
      faker.md
      msw.md
      mcp.md
      generators.md
      advanced.md
    guides/
      README.md
      architecture.md
      ast.md
      barrel-files.md
      concepts-plugins.md
      creating-plugins.md
      generators.md
      macros.md
      migration-guide.md
      printers.md
      publish-a-plugin.md
      recipes.md
      renderers.md
      resolver-customization.md
      resolvers.md
      submit-to-the-registry.md
      tutorial.md
  samples/
    README.md
    basic-typescript-generation.md
    react-query-hooks.md
    zod-schema-generation.md
    api-client-generation.md
    msw-mock-handlers.md
    multi-plugin-workflow.md
    multiple-specs.md
    programmatic-build.md
    filtering-and-grouping.md
  scripts/
    README.md
    cli.md
    generate.md
    install.md
    mcp.md

探索手順

タスクからカテゴリを引き、カテゴリの README.md で目的のページを特定する:

  1. 下記マッピング表でタスクに対応するカテゴリを探す
  2. そのカテゴリの references/{category}/README.md を参照して目的のページを特定する
  3. 該当ページの .md を Read して詳細を確認する

タスク → カテゴリ マッピング

タスクカテゴリ参照 README
インストール、初期設定、クイックスタートgetting-startedreferences/getting-started/README.md
トラブルシューティング、テレメトリー設定getting-startedreferences/getting-started/README.md
kubb.config.ts のトップレベルオプション・デフォルト値referencereferences/reference/README.md(configuration)
複数プラグイン共通のオプションreferencereferences/reference/README.md(plugin-options)
TypeScript 型・API クライアント(plugin-client 自前クライアント / Fetch / Axios)生成pluginsreferences/plugins/README.md
Zod スキーマ・Faker モック・MSW ハンドラー生成pluginsreferences/plugins/README.md
React Query / Vue Query / SWR hooks 生成(Solid Query / Svelte Query は v5 で削除)pluginsreferences/plugins/README.md
barrel(index.ts)出力、Cypress テスト定義・MCP サーバー・Redoc ドキュメント生成pluginsreferences/plugins/README.md
プラグイン別 how-to(認証・baseURL・interceptors・SSE・transport・エラー処理・シリアライズ・バリデーション)plugin-guidesreferences/plugin-guides/README.md
OpenAPI 仕様のパース・アダプター(@kubb/adapter-oas)adaptersreferences/adapters/README.md
Kubb の AST から TypeScript / Markdown ソースへの変換(parser-ts / parser-md)parsersreferences/parsers/README.md
Kit API(kubb/kit)の概念別リファレンス(plugins / generators / resolvers / hooks / storage / testing)kitreferences/kit/README.md
ビルド失敗時の診断メッセージ、JSX・シリアライズ仕様referencereferences/reference/README.md
CLI 各コマンド(init / generate / validate / mcp / studio / add / update / list)commandsreferences/commands/README.md
Kubb Studio、CI スナップショット、GitHub Actions / GitLab 連携integrationsreferences/integrations/README.md
拡張レジストリ(kubb add)の利用・拡張の登録申請reference / guidesreferences/reference/README.md(registry)、references/guides/README.md(submit-to-the-registry)
CLI ヘルパー概要、MCP サーバー統合、Vite / webpack / Rollup / esbuild / Rolldown / Rspack / Farm / Nuxt / Astro 統合helpersreferences/helpers/README.md
Claude Code / Claude Desktop 連携、Context7、llms.txt、AI アシスタントからの MCP サーバー利用aireferences/ai/README.md
各プラグインの kubb.config.ts 設定例、カスタムジェネレーターexamplesreferences/examples/README.md
アーキテクチャ、AST・Resolver・Renderer・Printer 概念の理解guidesreferences/guides/README.md
カスタムプラグインの作成・公開、Macro・Resolver のカスタマイズ、barrel files、レシピguidesreferences/guides/README.md
v4→v5 マイグレーション、ステップバイステップチュートリアルguidesreferences/guides/README.md
典型的な使い方・ワークフローを知りたいsamplessamples/README.md
インストール・CLI コマンド・generate コマンドを実行したいscriptsscripts/README.md

Comments

Markdown supported