ツールとスキルを管理する

ツールとスキルは、コア uip ホストの横にある 2 つの拡張システムです。ツールは 、UiPath サービスと通信するコマンドを追加します。 スキル は、AI コーディング エージェントにこれらのコマンドの操作方法を教えます。どちらも、CLI 自体を使用してインストール、更新、および削除されます。このページでは、概念的な分割 ( ツール (プラグイン) と スキルを参照) や完全なコマンド リファレンス ( uip ツールと uip スキルを参照) ではなく、日常的なワークフローについて説明します。

ツール — 日常

インストールされているものを確認する

uip tools list --output table

name、version、commandPrefixのテーブルを返します。これを使用して、開発者のラップトップとビルドサーバー間のドリフトを見つけます。

スナップショットをキャプチャするには、後で差分を設定します。

uip tools list --output json --output-filter "Data[*].{name: name, version: version}" > tools.json

ツールをインストールする

3つの識別子形式が機能します—コンテキストで最もよく読めるものを選択してください。

uip tools install or                                # alias (shortest)
uip tools install orchestrator-tool                 # short name
uip tools install @uipath/orchestrator-tool         # full npm name

明示的なバージョン(CIの再現性):

uip tools install orchestrator-tool@1.0.2

プレビュー チャンネル:

uip tools install flow-tool@beta

CIでは、必要なツールを常に専用のステップとしてインストールしてください — 自動インストールでは、最初に実行されたコマンドに1回限りのダウンロードコストがかかり、env-varのオプトアウトはありません(詳細)。

uip tools install @uipath/orchestrator-tool \
                  @uipath/solution-tool \
                  @uipath/test-manager-tool

CLIバンプ後のツールのアップグレード

@uipath/cliをアップグレードしても、インストール済みのツールは以前のバージョンのまま残ります。uip tools updateを実行して、CLI の新しい MAJOR 内の最新バージョンにします。マイナーライン:

npm install -g @uipath/cli@1.1.0
uip tools update

単一のツールを更新します。

uip tools update --name orchestrator-tool

特定のツールを正確なバージョンにピン留めします。

uip tools update --name orchestrator-tool --version 1.0.3

UpdateResult のDataでは、ツールごとのfrom → to差分が表示されるため、監査ログに役立ちます。

ヒント:

アップグレード後にシェルの完了をリフレッシュ

シェル補完スクリプトは、最後の実行時に認識される動詞とフラグ uip completion 静的なスナップショットです。npm install -g @uipath/cli@<new>、uip tools install、または uip tools updateの後に uip completion を再実行すると、新しく追加したコマンドとフラグが <TAB>に表示されます。uip completion — Static snapshotを参照してください。

ツールを削除する

uip tools uninstall or

アンインストール後、自動インストールがブロックされない限り、次の uip or … 呼び出しで自動インストールが再度トリガーされます(オフラインランナー、ホワイトリストピン留め)。ステートレスランナーでツールを実行し続けるには、必要なツールのみをプリインストールし、アンインストールされたツールを呼び出さないでください。

環境間の監査ドリフト

各環境で、インストールされているセットをキャプチャします。

uip tools list --output json --output-filter "Data[*].{name: name, version: version}" | jq -S . > tools.$(hostname).json

複数の環境間でファイルを差分検出します。どのデルタも "works on my machine" のソースです — CI でピン留めすることで解決します。

スキル — 日常

インストールされているものを確認する

ls ~/.uipath/.skills         # the on-disk skill catalog cache
cat ~/.uipath/.skills/manifest.json   # manifest of installed skills per agent

ローカル インストールの場合、ストアは ./.uipath/.skills/のプロジェクト ルートの下に存在します。または、エージェントにインストール済みのスキルのリストを依頼します。サポートされているすべてのエージェントは、独自のUI/コマンドでこれを公開します。

コーディングエージェントへのスキルのインストール

エージェント別:

uip skills install --agent claude        # Claude Code (global only)
uip skills install --agent cursor        # Cursor
uip skills install --agent copilot       # GitHub Copilot
uip skills install --agent gemini        # Gemini CLI
uip skills install --agent codex         # Codex
uip skills install --agent opencode      # OpenCode

インタラクティブ(チェックボックスを介して複数選択):

uip skills install

範囲:

• デフォルトは グローバル です — エージェントのユーザープロファイルにインストールされます。エージェントが実行されるすべての場所で使用できます。
• --local は代わりに現在のディレクトリにインストールされます。プロジェクトピン留めされたスキルや、ユーザー プロフィールを煩雑にしたくない場合に適しています。Claude Code はグローバル専用で、--agent claudeエラーを出して--localを渡します。

スキルを新鮮に保つ

uip skills update UiPath スキル カタログを再取得して再インストールします。

uip skills update --agent claude

また、前回のインストール以降にリモート カタログから削除されたスキルも削除されます。エージェントは、UiPath のリリース セットと歩調を合わせることができます。

スキルを削除する

uip skills uninstall --agent claude

エージェント自体を削除したり、他のエージェントのスキルに影響を与えたりすることはありません。スキルを削除するエージェントごとに 1 回実行します。

プロジェクトでツールとスキルを組み合わせる

UiPath の作業に AI コーディング エージェントを使用するリポジトリに共通するパターンは、以下のとおりです。

1. プロジェクトドキュメントに @uipath/cli をピン留めします( package.json ではなく、CLIはオペレーターのマシンに対する開発依存関係であり、プロジェクトランタイムdepではありません)。
2. README に、プロジェクトが対象とする外部アプリケーションとテナントを記述します。各コントリビューターは、対応する環境変数を自分のマシンに設定し、 uip loginでサインインします。
3. プロジェクト関連のツールを各コントリビューターのマシンにインストールします。

   uip tools install or solution tm
   

4. プロジェクトで使用されるコーディング エージェントのスキルをローカルにインストールします。

   uip skills install --agent cursor --local
   

5. ローカルの skills-store ディレクトリを .gitignore に追加します (install コマンドは最初の実行時にパスを出力します)。

リポジトリで実行されているエージェントは共同作成者のセッションで認証され、スキルは uipの使用方法を教え、ピン留めされたツールはビルドの再現性を維持します。

物事がうまくいかないとき

ツールのコマンドが uip --help に表示されない

ツールがインストールされていないか、読み込みに失敗しました。チェック：

uip tools list                  # is it installed?
uip --log-level debug or folders list   # what does the host say during tool load?

エラーで読み込まれたツールは、補完ツリーとコマンドディスパッチャーによってサイレントにスキップされます。

ツールをインストールしてもコマンドが「不明なオプション」で失敗する

バージョンの不一致の可能性があります—ツールは別のCLIマイナー行に対してビルドされました。uip tools update --name <tool>で修正します。

スキルがコーディング エージェントに表示されない

各エージェントは、独自のプラグイン/ルール システムを介してスキル ファイルを処理します。uip skills install --agent <name>後:

• Claude Code — Claude Codeを再起動します。スキルはプラグイン ピッカーの下に表示されます。
• カーソル — スキルは次の会話で自動ロードされます。 ~/.cursor/skills/ (グローバル) または ./.cursor/skills/ (ローカル) をオンにします。
• GitHub Copilot — [Copilot] パネルを開くスキルは ~/.github/skills/ (グローバル) または ./.github/skills/ (ローカル) の下位にあります。
• Gemini CLI — スキルは ~/.gemini/skills/ または ./.gemini/skills/用に記述されます。
• Codex — スキルは ~/.agents/skills/ または ./.agents/skills/ (開いているエージェント スキルの標準ディレクトリ) に書き込まれます。
• OpenCode — スキルは ~/.config/opencode/skills/ (グローバル) または ./.opencode/skills/ (ローカル) に記述されます。

uip skills install --agent <name> --print (または対話モードの同等のチェックボックス) を実行して、正確な宛先を確認します。

参照

• ツール (プラグイン) — host-plus-plugins モデル。
• スキル — AI エージェント拡張システム。
• UIP Tools Reference — 完全なフラグ リスト。
• UIP Skills Reference — 完全なフラグ リスト。
• UiPath CLI のインストール — ツールの自動インストールの制御 — CI での自動インストールの動作。
• UiPath CLI をコーディング エージェントと使用する — エージェントごとのセットアップに関するチュートリアル。