neutree-ai/openapi-to-skills

解決する課題

AI エージェントは、大規模な OpenAPI 仕様が LLM のコンテキスト制限を超えたり、不要な情報を読み込んでトークンを浪費したりするため、しばしば苦労します。このツールは、モノリシックな OpenAPI ファイルを構造化されたモジュール形式に変換し、エージェントが必要な特定のドキュメントのみをオンデマンドで読み取れるようにします。

仕組み

OpenAPI 仕様（ローカルファイルまたは URL から）を受け取り、階層的な小さな焦点を絞った Markdown ファイルのセットに分解します。この構造は、リソース、操作、スキーマごとにコンテンツを整理します。これらのファイルは標準的な Markdown であるため、ファイルを読み取れる AI エージェントは、概要から始めて必要に応じて特定のセクションにドリルダウンすることでドキュメントをナビゲートできます。

対象読者

パフォーマンスを犠牲にしたりコンテキストウィンドウの制限に達したりすることなく、複雑な API ドキュメントへのアクセスをモデルに提供したい AI エージェントを構築する開発者。

ハイライト

• モジュール出力：巨大な API 仕様を数千の小さなナビゲート可能なファイルに分割します。
• コンテキスト効率：エージェントが仕様全体ではなく関連する API 操作やスキーマのみを読み込めるようにします。
• 柔軟なフィルタリング：特定のタグ、パス、または非推奨の操作を含めたり除外したりできます。
• カスタマイズ可能：Eta テンプレートによるカスタム出力テンプレートをサポートし、ビルドパイプラインへの統合のためのプログラム API を提供します。