メインコンテンツへスキップ
このドキュメントは AI によって自動翻訳されています。不正確な部分がある場合は、英語版 を参照してください。
skills install は、difyctl スキル（SKILL.md ファイル）を、お使いのマシン上にある各コーディングエージェントのスキルディレクトリへ書き込みます。 このスキルには、あえてコマンドを一切記載していません。代わりにエージェントを difyctl help -o json に誘導し、利用可能なコマンド群をエージェント自身に発見させます。その発見の仕組みは help リファレンス を、統合の全体像は difyctl スキルをインストールする を参照してください。

​
スキルのインストール

difyctl skills install [dir] [flags]
このコマンドは完全にローカルで動作します。サインインは不要で、サーバーへの接続も一切行いません。

​
引数

  • dir：省略可能。この単一ディレクトリにインストールし、エージェント検出をスキップします。スキルは <dir>/SKILL.md に書き込まれます。--agent とは併用できません。

​
フラグ

フラグ型デフォルト説明
-y, --yesbooleanfalseスキルを書き込みます。このフラグがない場合はドライランとなり、スキルの書き込み先を一覧表示するだけで何も書き込みません。
--agentstring、繰り返し可能なしインストール対象を、検出済みの特定エージェントに名前で限定します。フラグを繰り返すか、カンマ区切りのリストを渡します。検出されていないエージェントを指定すると、使用方法のエラーになります。
--stdoutbooleanfalseスキルを stdout に出力し、何も書き込みません。--yes、--agent、dir とは併用できません。

​
例

スキルのインストール先をプレビューする（ドライラン、デフォルトの動作）： 
difyctl skills install
検出されたすべてのエージェントにインストールする： 
difyctl skills install --yes
1 つのエージェントだけにインストールする： 
difyctl skills install --yes --agent claude-code
CLI が検出しないエージェント向けに、明示したディレクトリへインストールする： 
difyctl skills install ./my-skills/difyctl --yes
何も書き込まずにスキルを出力する： 
difyctl skills install --stdout

​
エージェント検出

検出では、各エージェントの設定ディレクトリが存在するかどうかを確認します。CLI が PATH を調べたり、何かを起動したりすることはありません。スキルは、各エージェントの公式ドキュメントに記載されたユーザーレベルのスキル配置先へ書き込まれます。
エージェント検出条件スキルの配置先
claude-code~/.claude が存在する~/.claude/skills/difyctl/SKILL.md
codex~/.codex が存在する~/.agents/skills/difyctl/SKILL.md
opencode~/.config/opencode が存在する~/.config/opencode/skills/difyctl/SKILL.md
cursor~/.cursor が存在する~/.cursor/skills/difyctl/SKILL.md
pi~/.pi が存在する~/.pi/agent/skills/difyctl/SKILL.md
インストール済みでも一度も起動していないエージェントは、設定ディレクトリがまだ存在しない場合があります。その場合は difyctl skills install <dir> でスキルディレクトリへ明示的にインストールしてください。

​
出力

ドライランでは、検出されたエージェントとその対象パスを一覧表示し、続いて次の進め方を案内します。 
Detected 2 agents: claude-code, cursor

would write to claude-code: /Users/you/.claude/skills/difyctl/SKILL.md
would write to cursor: /Users/you/.cursor/skills/difyctl/SKILL.md

Re-run with --yes to write all, or --agent <name> to write only some.
Agent not listed? Install into its directory with `difyctl skills install <dir>`.
--yes を付けると、書き込みごとに確認が表示されます。 
wrote /Users/you/.claude/skills/difyctl/SKILL.md
wrote /Users/you/.cursor/skills/difyctl/SKILL.md
何も検出されない場合、コマンドは代替手段を案内して 0 で終了します。 
No agents detected (looked for ~/.claude, ~/.codex, ~/.config/opencode, ~/.cursor, ~/.pi).
Install into a directory manually with `difyctl skills install <dir>`, or
print the skill with `difyctl skills install --stdout`.
インストールされたスキルには、それを書き込んだ CLI と一致するバージョンスタンプが付きます。アップグレード後に skills install --yes を再実行すると、ファイルが現在のバージョンに置き換わります。再実行は常に安全です。

​
終了コード

コード意味
0成功。ドライランや、何も検出されなかった場合を含む
1ローカルでの失敗。たとえば対象ディレクトリに書き込めない場合
2使用方法のエラー：--stdout と書き込みオプションの併用、dir と --agent の併用、または --agent で検出されていないエージェントを指定した場合
最終更新日 2026年6月25日