コマンドラインからAIコーディングエージェントに直接Olostepスキルフォルダをインストールします。
- Cursor、Claude、Codex、WindsurfなどのエージェントにOlostepスキルをインストール
- スキルは標準ストア (
~/.agents/skills) に配置され、各エージェントのスキルディレクトリにシンボリックリンクまたはコピーされます
- すべてのインストールを
~/.agents/.skill-lock.json のロックファイルで追跡
この機能は Olostep CLI で利用可能です。
olostep add skills
スキルをソースディレクトリからCLIに同期し、標準ストアにインストールし、各エージェントのスキルディレクトリに展開します。
CLIのインストール
# グローバルインストール
npm install -g olostep-cli
# またはインストールせずに実行
npx -y olostep-cli@latest add skills
使用法
# すべての検出されたエージェントにすべてのスキルをインストール（デフォルト）
olostep add skills
# 認証後にインストール
olostep add skills --login
# 特定のエージェントを対象
olostep add skills --agent cursor --agent claude
# シンボリックリンクの代わりに常にコピー
olostep add skills --link-mode copy
# 機械可読のJSON出力
olostep add skills --json
オプション
| オプション | デフォルト | 説明 |
|---|
--login | — | インストール前にブラウザでログイン |
--source <path> | CLIバンドルスキルディレクトリ | スキルのソースディレクトリ |
--cli-local-dir <path> | CLI/skills | CLIローカル用にスキルを同期するディレクトリ |
--agent <name> | — | 特定のエージェントを対象 — 繰り返し可能 |
--all-agents / --no-all-agents | --all-agents | --agent が設定されていない場合、すべての検出されたインストール済みエージェントを対象 |
--global / --no-global | --global | 既知のエージェントのグローバルスキルディレクトリにインストール |
--canonical-dir <path> | ~/.agents/skills | Olostepスキルの標準ストレージ場所 |
--agent-skills-dir <path> | — | カスタムターゲットスキルディレクトリ（--no-global が必要） |
--skill <name> | — | このスキルのみを含める — 繰り返し可能 |
--exclude <name> | — | このスキルを除外 — 繰り返し可能 |
--overwrite / --no-overwrite | --overwrite | 既存のターゲットを置き換える |
--link-mode <auto|symlink|copy> | auto | auto はシンボリックリンクを試み、コピーにフォールバック |
--json | — | 機械可読のJSON出力を生成 |
検証ルール:
--link-mode は auto、symlink、または copy でなければなりません--agent-skills-dir は --no-global が必要--no-global は --agent-skills-dir が必要- 不明なエージェント名はエラーになります
--skill / --exclude の後にスキル選択が空の場合はエラーになります
JSON出力
{
"sync": {
"plugin_source_dir": "/path/to/CLI/skills",
"cli_local_dir": "/path/to/CLI/skills"
},
"selected_skills": ["research-agent"],
"canonical_dir": "~/.agents/skills",
"lockfile_path": "~/.agents/.skill-lock.json",
"installed": [
{
"skill": "research-agent",
"canonical_path": "~/.agents/skills/olostep-research-agent",
"targets": [
{ "agent": "cursor", "mode": "symlink", "path": "~/.cursor/skills/olostep-research-agent" },
{ "agent": "claude", "mode": "symlink", "path": "~/.claude/skills/olostep-research-agent" }
]
}
]
}
スキルの発見とフォーマット
スキルは SKILL.md ファイルを持つサブディレクトリをスキャンすることで発見されます。ファイルには name と description フィールドを含むフロントマターブロックが必要です。重複するサニタイズされた名前は拒否されます。
---
name: research-agent
description: ディープウェブ調査のための自律型リサーチエージェント
---
# リサーチエージェント
...スキルの説明はこちら...
対応エージェント
| エージェント | キー |
|---|
| Cursor | cursor |
| Claude | claude |
| Codex | codex |
| Windsurf | windsurf |
| Continue | continue |
| Augment | augment |
| Roo | roo |
| Gemini | gemini |
| Copilot | copilot |
| Factory | factory |
--all-agents（デフォルト）を使用するか、特定のものを対象にするには --agent <key> を渡します。
命名規則
インストールされたフォルダ名は常に olostep- プレフィックスを使用します。例：research-agent は olostep-research-agent になります。名前は小文字にサニタイズされ、無効な文字は - に置き換えられます。このプレフィックスにより、Olostepが管理するスキルが明確に識別され、他のツールとの競合を防ぎます。
olostep remove skills
Olostepがインストールしたスキルフォルダを標準ストアとエージェントスキルディレクトリから削除し、ロックファイルをクリーンアップします。
使用法
# すべてのエージェントからすべてのOlostepスキルを削除
olostep remove skills
# 特定のスキルを削除
olostep remove skills --skill research-agent
# 特定のエージェントのみから削除
olostep remove skills --agent cursor
# 機械可読のJSON出力
olostep remove skills --json
オプション
| オプション | デフォルト | 説明 |
|---|
--agent <name> | — | 指定されたエージェントからのみ削除 — 繰り返し可能 |
--all-agents / --no-all-agents | --all-agents | --agent またはカスタムディレクトリがない場合、すべての検出されたインストール済みエージェントを使用 |
--canonical-dir <path> | ~/.agents/skills | 削除する標準スキルディレクトリ |
--agent-skills-dir <path> | — | 削除用のカスタムターゲットスキルディレクトリ |
--skill <name> | — | 一致するスキルのみを削除 — 繰り返し可能 |
--json | — | 機械可読のJSON出力を生成 |
安全性: olostep- プレフィックスを持つフォルダのみが対象となります。非Olostepエージェントフォルダは変更されません。ロックファイルのクリーンアップは olostep- プレフィックス付きキーのみを削除します。
