スキル

コマンドラインからAIコーディングエージェントに直接Olostepスキルフォルダをインストールします。

Cursor、Claude、Codex、WindsurfなどのエージェントにOlostepスキルをインストール
スキルは標準ストア (~/.agents/skills) に配置され、各エージェントのスキルディレクトリにシンボリックリンクまたはコピーされます
すべてのインストールを ~/.agents/.skill-lock.json のロックファイルで追跡

この機能はOlostep CLIを通じて利用可能です。

olostep add skills はこれらすべてをインストールします。各スキルはエージェントがOlostepが何をできるか、いつ使用するかを知るための SKILL.md です。

スキル	内容
`scrape`	1つのURLをクリーンなmarkdown / HTML / JSON / テキストに変換
`search`	ライブウェブ検索 — 結果、回答、サイト内URLの発見
`answers`	ライブウェブデータからの引用付き構造化回答
`crawl`	サイト全体を自動的にクロール
`map`	サイト上のすべてのURLを発見
`batch`	最大10,000のURLを並列でスクレイプ
`extract-schema`	ページをスキーマに一致する構造化JSONにスクレイプ
`docs-to-code`	APIドキュメントをスクレイプして動作するコードを作成
`integrate`	プロジェクトにOlostep SDKを自動インストール
`migrate-code`	マイグレーションガイドを読み、ローカルコードを更新
`research`	決定のための引用付き比較ウェブリサーチ
`debug-error`	ライブのGitHub / SO / ドキュメントに対してエラーメッセージを検索
`setup`	エージェントにMCPサーバーの設定方法を教える

スキルはMCPサーバーと連携します：MCPサーバーはエージェントにライブのツールを提供し、スキルはそれをいつ、どのように使用するかのノウハウを提供します。

カテゴリー

すべてのスキルは3つのカテゴリーのいずれかに属します：

使用スキル — Olostepの機能を使用する：scrape、search、answers、crawl、map、batch。
構築スキル — Olostepをコードベースにインストールして統合する：setup（MCPサーバーの設定）とintegrate（プロジェクトにOlostep SDKを追加）。
ワークフロースキル — Olostepで成果物を作成する：research、docs-to-code、migrate-code、debug-error、extract-schema。

olostep add skills --category usage（またはbuild、workflow）で1つのカテゴリーだけをインストールします。インストールされた各スキルは、https://www.olostep.com/skills/<name>/SKILL.md にホストされたコピーも参照します — ウェブアクセスがあるエージェントは最新バージョンを取得できます（インストール以降に機能が追加されている可能性があります）、そうでない場合はローカルコピーを使用します。すべてのホストされたスキルはolostep.com/skillsで閲覧できます。

`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" }
      ]
    }
  ]
}

`olostep list skills`

どのスキルがインストールされ、どのエージェントにインストールされているかをファイルを掘り下げずに確認できます。

olostep list skills            # 人間が読める要約
olostep list skills --json     # 機械可読

スキルの発見とフォーマット

スキルはサブディレクトリをスキャンして 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- プレフィックスのキーのみを削除します。

Documentation Index

​スキル

​カテゴリー

​olostep add skills

​CLIのインストール

​使用方法

​オプション

​JSON出力

​olostep list skills

​スキルの発見とフォーマット

​対応エージェント

​命名規則

​olostep remove skills

​使用方法

​オプション

スキル

カテゴリー

`olostep add skills`

CLIのインストール

使用方法

オプション

JSON出力

`olostep list skills`

スキルの発見とフォーマット

対応エージェント

命名規則

`olostep remove skills`

使用方法

オプション