Ultralytics Agent Skills#
Ultralytics Agent Skillsは、互換性のあるAIコーディングエージェントに、ultralytics Pythonパッケージ、yolo CLI、およびUltralytics Platformを利用するための手順とリファレンス資料を提供します。これには、ul cloudによる自動化も含まれます。オープンなAgent Skills形式に準拠しており、関連するタスクが依頼されると読み込まれます。
スキルの仕組み#
yoloルータースキルは、リクエストを関連するライフサイクルの段階に振り分け、各段階のスキルは2つの方法をカバーします。まずUltralytics Platformで最も手早く進める方法、次にローカルでのPythonおよびCLIワークフローです。重みの名称、トレーニング引数、エクスポート形式など、バージョンに依存する情報は、固定されたultralyticsリリースに基づくカタログに記載されています。また、各スキルは、情報が異なる場合にはインストール済みパッケージ(yolo checks、yolo cfg、およびエラーメッセージ)を信頼するようエージェントに指示します。一方、platform-cliスキルは、インストール済みのul CLIヘルプとライブのPlatform APIを参照します。Platform独自のAsk AIも、同じplatform-cliスキルを使用します。
利用可能なスキル#
リポジトリには、ルーター1つ、ライフサイクルスキル6つ、Platform CLIスキル1つが含まれています。
| スキル | 用途 |
|---|---|
yolo | PythonとCLIの基本的な使い方、Platformのワークフロー、他のスキルへの振り分け |
yolo-models | モデルファミリー、サイズ、タスク、重みの選択 |
yolo-datasets | データセットの準備、変換、検証、トラブルシューティング |
yolo-training | トレーニング、検証、再開、マルチGPUの使用、トラブルシューティング |
yolo-tuning | ハイパーパラメータのチューニングと実験の改善 |
yolo-inference | 予測、結果、トラッキング、Solutions |
yolo-export | エクスポート、量子化、デプロイ形式、ベンチマーク |
platform-cli | ul cloudを使用したUltralytics Platformの自動化:リソース、アップロード、クラウドトレーニング、エクスポート、デプロイ |
インストール#
claude plugin marketplace add ultralytics/skills
claude plugin install yolo@ultralytics更新するには、claude plugin update yolo@ultralyticsを実行してClaude Codeを再起動してください。
プラグインの各バージョンは、リリースノートとともにGitHubリリースとして公開されます。
Platform CLIを接続する#
platform-cliスキルは、pip install ultralyticsまたはスタンドアロンSDK(pip install ultralytics-platform)に含まれるul CLI(Python 3.11以降)を使用します。Platform APIキーを作成してエージェントが利用できるようにし、接続を確認してください。
export ULTRALYTICS_API_KEY="YOUR_API_KEY" # or: ul login YOUR_API_KEY
ul cloud account summaryプロンプトの例#
インストールしたら、自然な言葉でエージェントに依頼してください。yoloルーターが関連するガイダンスを選択します。
| 目的 | プロンプトの例 |
|---|---|
| YOLOを試す | 「サンプル画像にYOLOを適用して、検出したものを見せてください。」 |
| 学習 | 「画像にラベルを付けてUltralytics Platformでトレーニングし、カスタムYOLOモデルを作成してください。」 |
| 改善する | 「モデルのmAPが頭打ちになりました。実行内容を診断し、次の実験を提案してください。」 |
| デプロイする | 「トレーニング済みのYOLOモデルをINT8量子化でTensorRTにエクスポートし、ベンチマークを実行してください。」 |
| 動画を分析する | 「traffic.mp4で線を横切る車の台数を数え、注釈付き動画を保存してください。」 |
| Platformを自動化する | 「Ultralytics Platformのデータセットを一覧表示し、PPEデータセットでクラウドトレーニングを開始してください。」 |
最新のインストールコマンド、ソースファイル、更新情報、問題の報告については、ultralytics/skillsリポジトリをご覧ください。
よくある質問#
Ultralytics Platform、
ultralyticsPythonパッケージ、yoloCLI、ulPlatform CLIをAIコーディングエージェントが利用するための、再利用可能な手順とリファレンス資料です。リポジトリには、Claude CodeとCodex用のプラグインが用意されています。Cursor、Gemini CLI、およびオープンなAgent Skills形式を読み取れるその他のエージェントは、スキルフォルダーを直接、またはskills CLIを通じてインストールできます。
コンピュータービジョンのライフサイクル全体とPlatform CLI操作を自動で振り分けるには、プラグイン一式をインストールしてください。skills CLIで1つのスキルをインストールするには、
--skillに続けてスキル名を指定します。たとえば、--skill yolo-trainingまたは--skill platform-cliを指定します。プラグイン自体には指示のみが含まれているため、読み込み時に何かが実行されることはありません。スキルを使ってエージェントが実行するコマンドは、パッケージ、重み、データセットをダウンロードする場合があります。また、
ul cloudコマンドは、指定したファイルをAPIキーを使ってUltralytics Platformにアップロードします。ultralyticsパッケージは匿名の使用状況分析データも送信しますが、yolo settings sync=Falseによって無効になります。いいえ。スキルはエージェントを関連するワークフローに導きますが、動作やサポートされるオプションに違いがある場合は、インストール済みのパッケージと最新のUltralyticsドキュメントが引き続き正式な情報源となります。
使用したプロンプト、エージェントから提示されたガイダンス、および本来の動作を添えて、
ultralytics/skillsリポジトリにバグレポートを作成してください。