手動インストール

GitHubリポジトリのクローンとスキルファイルのコピーによるKeeper Agent Kitの導入。エアギャップ環境および `SKILL.md` 形式に対応するエージェント向け。

本書では、GitHubリポジトリをクローンしてスキルファイルを配置する手動インストールを説明します。エアギャップ環境にある場合、Node.jsがない場合、インストール内容を細かく管理したい場合に有効な手順です。より手早くセットアップする場合は、AIエージェント向けのインストール方法一覧をご参照ください。

---

手順1: リポジトリのクローン

git clone https://github.com/Keeper-Security/keeper-agent-kit
cd keeper-agent-kit

手順2: エージェントにスキルをコピー

エージェントごとにスキルを置くディレクトリが異なります。下表で使用するエージェントの行を確認し、右列のパスへファイルをコピーしてください。

エージェント	スキル格納パス
Claude Code (グローバル)	~/.claude/skills/
Claude Code (プロジェクト)	./.claude/skills/
Cursor (グローバル)	~/.cursor/skills/
Cursor (プロジェクト)	./.cursor/skills/
Codex	~/.codex/skills/
GitHub Copilot	~/.github/skills/
VS Code (Copilot Chat)	./.github/skills/
OpenCode	~/.opencode/skills/
Gemini CLI	~/.gemini/skills/

例: Claude Code (グローバルインストール)

mkdir -p ~/.claude/skills
cp -r plugins/*/skills/* ~/.claude/skills/

例: Claude Code (プロジェクト単位、チームと共有)

mkdir -p .claude/skills
cp -r plugins/*/skills/* .claude/skills/

プロジェクト側に配置した場合は、.claude/skills/ をリポジトリにコミットすると、共同作業者も同じスキルを利用できます。

例: Cursor

mkdir -p ~/.cursor/skills
cp -r plugins/*/skills/* ~/.cursor/skills/

手順3: 動作確認

コピーしたらエージェントのセッションを再起動し、以下のようなプロンプトで試します。

"How do I list my KSM profiles?"

エージェントが ksm profile list と応答すれば、スキルが読み込まれています。

Claude Codeでは、/plugin を実行し、[インストール済み] タブでも確認できます。

---

個別スキルのインストール

必要なスキルが1つだけの場合は、該当するフォルダだけをコピーします。

# secretsスキルのみ
cp -r plugins/keeper-secrets/skills/keeper-secrets ~/.claude/skills/

# adminスキルのみ
cp -r plugins/keeper-admin/skills/keeper-admin ~/.claude/skills/

# setupスキルのみ
cp -r plugins/keeper-setup/skills/keeper-setup ~/.claude/skills/

---

複数エージェントへのセットアップ

複数のエージェントを使う場合、同じクローンからまとめてインストールできます。

# Claude Code、Cursor、Codex向け
for dir in ~/.claude/skills ~/.cursor/skills ~/.codex/skills; do
  mkdir -p "$dir"
  cp -r plugins/*/skills/* "$dir/"
done

または、シンボリックリンクで正本を1か所にまとめると、更新内容を各エージェントへまとめて反映しやすくなります。

CANONICAL=~/.agent-skills/keeper
mkdir -p "$CANONICAL"
cp -r plugins/*/skills/* "$CANONICAL/"

# 各エージェントへシンボリックリンク
ln -sf "$CANONICAL"/keeper-secrets ~/.claude/skills/keeper-secrets
ln -sf "$CANONICAL"/keeper-secrets ~/.cursor/skills/keeper-secrets
# ... スキルとエージェントごとに繰り返し

---

アップデート

GitHubから最新の変更を取得したあと、各エージェントのスキルディレクトリへファイルを再コピーします。

cd keeper-agent-kit
git pull
cp -r plugins/*/skills/* ~/.claude/skills/

---

アンインストール

エージェントのスキルフォルダから、該当するスキルディレクトリを削除します。

rm -rf ~/.claude/skills/keeper-secrets
rm -rf ~/.claude/skills/keeper-admin
rm -rf ~/.claude/skills/keeper-setup

他のエージェントに入れた場合も同様に繰り返します。

これで削除されるのはエージェント用スキルのみです。KSM CLIとコマンダーCLIはマシン上に残ります。