このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。
difyctl skills install を実行して、お使いのマシンのコーディングエージェント向けにスキルファイルを書き込みます。エージェントはそれを読み取り、自身で接続を完了します。
インストールされる SKILL.md はブートストラップであり、マニュアルではありません。エージェントに伝えるのは最も重要な 1 点だけです。difyctl help -o json を実行し、その出力を信頼できる唯一の情報源として扱うことです。
実行時、エージェントはインストール済みの difyctl から完全なコマンド一覧を読み取ります。
スキルを使う場面
- お使いのエージェントランタイムがスキルを読み取る場合：Claude Code、Codex、OpenCode、Cursor、pi、またはスキルディレクトリから
SKILL.mdファイルを読み取るその他のツール。 - エージェントが Shell コマンドを実行できる場合。スキルはエージェントの Shell ツールを介して
difyctlを駆動します。 - メンテナンス不要を望む場合：スキルはコマンドを一切列挙しないため、古くなることがありません。
difyctl help -o json を読み取ることで、difyctl を直接駆動できます。
前提条件
- エージェントが動作するマシンで
difyctlを インストール し、サインイン して、セッションを再利用できるようにします。サーバーやコンテナの場合は、エージェントの動作環境で認証する を参照してください。 - スキルを読み取り、Shell コマンドを実行できるコーディングエージェントを使用します。Shell へのアクセスがないサンドボックス化されたエージェントはスキルを使用できません。
- インストール前にエージェントを少なくとも 1 回起動し、
difyctl skills installが見つけられるよう設定ディレクトリを作成しておきます。
手順
1
スキルの書き込み先をプレビューする
--yes を付けない場合、このコマンドはドライランです。2
スキルを書き込む
--yes は検出されたすべてのエージェントに書き込みます。--agent <name> を渡すと、1 つだけに書き込みます。3
新しいエージェントセッションを開始する
新しいセッションを開始して、エージェントが受け取ったばかりのスキルをインデックス化できるようにします。
detection、エージェントごとのターゲットパス、
--agent、--stdout、明示的なディレクトリ指定の形式については、スキルリファレンスページ を参照してください。テスト
インストール時に書き込んだパスが表示されます。そのファイルを開いて、スキルが存在することを確認してください。次に、エージェントが実際にそれを使用しているか確認します。- 検出：新しいセッションで、エージェントに「
difyctlで何ができますか？」と尋ねます。正しく接続されたエージェントはdifyctl help -o jsonを実行し、コマンドを推測するのではなく、その出力に基づいて回答します。 - エンドツーエンド：エージェントに Dify アプリを一覧表示させ、そのうちの 1 つを実行させます。
difyctl get app -o jsonの後に、一覧の実際の ID を使ったdescribe/runのシーケンスが続くか確認します。 - 一時停止の処理：人間の入力ステップを持つ Workflow または Chatflow のアプリがある場合、エージェントにそれを実行させます。一時停止した実行は 0 で終了し、stdout に
"status": "paused"を報告します。エージェントは一時停止を認識して再開を申し出るべきであり、失敗を報告したり実行を再試行したりするべきではありません。
トラブルシューティング
その他の問題については、トラブルシューティング ページ全体を参照してください。