1 files changed, 65 insertions, 0 deletions
diff --git a/website/src/content/docs/ja/agent-skill.mdx b/website/src/content/docs/ja/agent-skill.mdx
new file mode 100644
index 00000000..1fc6405d
--- /dev/null
+++ b/website/src/content/docs/ja/agent-skill.mdx
@@ -0,0 +1,65 @@
+---
+title: エージェントスキルファイル
+description: Claude Code などのコーディングエージェントに Herdr の使い方をインストールします。
+---
+
+Herdr は再利用可能なエージェントスキルファイルを [`SKILL.md`](https://github.com/ogulcancelik/herdr/blob/master/SKILL.md) として提供しています。
+
+このファイルを、再利用可能なスキルやカスタム指示に対応した任意のコーディングエージェントにインストールしてください。このスキルは、Herdr のペイン内から Herdr を制御する方法をエージェントに教えます。
+
+Herdr は別の用途向けに [`herdr.dev/agent-guide.md`](https://herdr.dev/agent-guide.md) というガイドも提供しています。こちらは、人間が Herdr を学習・セットアップ・トラブルシューティングするのをエージェントが手伝うためのものです。スキルは Herdr を操作するエージェントのため、ガイドは人間に教えるエージェントのためのものです。
+
+## スキルがすること
+
+このスキルは、`HERDR_ENV=1` が設定されているときに `herdr` CLI を使うようエージェントに指示します。これは、エージェントが Herdr 管理下のペイン内で動作しており、ローカルの Herdr ソケットと安全に通信できることを意味します。
+
+スキルをインストールすると、エージェントは次のことができます:
+
+- ワークスペース、タブ、ペイン、隣のエージェントを調べる
+- フォーカスを奪わずにペインを分割してコマンドを実行する
+- ペインの出力と最近のログを読む
+- サーバー、テスト、別のエージェントの完了を待つ
+- 隣のペインでヘルパーエージェントを起動する
+
+このスキルは独立したアプリやサービスではありません。エージェント向けの markdown 指示ファイルです。
+
+## インストールする
+
+`npx skills` でスキルをインストールします:
+
+```bash
+npx skills add ogulcancelik/herdr --skill herdr -g
+```
+
+`-g` フラグは、対応エージェントにグローバルインストールします。現在のプロジェクトにインストールする場合は `-g` を省略してください。
+
+手動でのフォールバックおよび信頼できるソースとしては、リポジトリのコピーを使ってください:
+
+```text
+https://github.com/ogulcancelik/herdr/blob/master/SKILL.md
+```
+
+スキルシステムを持つエージェントには、このファイルを `herdr` という名前のスキルとしてインストールしてください。スキルシステムを持たないエージェントには、ファイルの内容をプロジェクト指示またはユーザー指示に貼り付けてください。
+
+インストール後、Herdr の中でエージェントを起動します:
+
+```bash
+herdr
+claude
+```
+
+他のコーディングエージェントを Herdr のペインで使っても構いません。重要なのは、エージェントのプロセスが Herdr 内で動作していて `HERDR_ENV=1` が利用できることです。
+
+## 安全ルール
+
+このスキルはひとつのガードレールから始まります: `HERDR_ENV=1` が設定されていない場合、エージェントは停止して、Herdr 管理下のペイン内で動作していないと伝えるべきです。
+
+これにより、Herdr の外にいるエージェントが自分のものではないセッションを制御しようとするのを防ぎます。
+
+## エージェント向けリファレンス
+
+コマンドの完全なガイドはスキルファイル自体にあります。ペイン ID、`pane split`、`pane run`、`pane read`、`wait output`、`wait agent-status`、ワークスペースとタブのコマンド、協調動作のレシピを扱っています。
+
+ソースファイルはこちら:
+
+[GitHub で `SKILL.md` を開く →](https://github.com/ogulcancelik/herdr/blob/master/SKILL.md)