コマンドラインからAIコーディングエージェントに直接Olostepスキルフォルダをインストールします。
- スキルは標準ストア (
~/.agents/skills) に配置され、各エージェントのスキルディレクトリにシンボリックリンクまたはコピーされます
- すべてのインストールを
~/.agents/.skill-lock.json のロックファイルで追跡
- Cursor、Claude、Codex、Windsurf、Continueなどに対応
この機能はOlostep CLIを通じて利用可能です。
スキル
olostep add skills は全13スキルをインストールします。各スキルはエージェントがOlostepが何をできるか、そしていつ使うべきかを知るために読む SKILL.md です。
スキルはMCPサーバーと連携します：MCPサーバーはエージェントにライブのツールを提供し、スキルはそれをいつどのように使うかのノウハウを提供します。
セットアップ
ここから始めます — エージェントにOlostep MCPサーバーの設定方法を教えます。
| スキル | 何をするか |
|---|
setup | Olostep MCPサーバーを設定し、他のすべてのスキルが動作するようにします |
コアウェブデータ
主要なOlostepの機能 — これらを使用してエージェントにライブウェブアクセスを提供します。
| スキル | 何をするか |
|---|
scrape | 1つのURLをクリーンなmarkdown / HTML / JSON / テキストに変換 |
search | ライブウェブ検索 — 結果、回答、サイト内URLの発見 |
answers | ライブウェブデータから引用された構造化された回答 |
crawl | サイト全体を自動でクロール |
map | サイト上のすべてのURLを発見 |
batch | 最大10,000のURLを並行してスクレイプ |
extract-schema | ページをスキーマに一致する構造化JSONにスクレイプ |
ビルド＆統合
開発者がOlostepをコードベースに追加したり、APIの変更に追従するのを助けるエージェント向け。
| スキル | 何をするか |
|---|
integrate | プロジェクトにOlostep SDKを自動インストール |
docs-to-code | APIドキュメントをスクレイプし、そこから動作するコードを作成 |
migrate-code | マイグレーションガイドを読み、ローカルコードを更新 |
リサーチ＆デバッグ
リサーチを行ったり、意思決定をしたり、コードエラーをデバッグするエージェント向け。
| スキル | 何をするか |
|---|
research | 意思決定のための引用された比較ウェブリサーチ |
debug-error | ライブのGitHub / SO / ドキュメントに対してエラーメッセージを調べる |
カテゴリー
すべてのスキルは3つのカテゴリーのいずれかに属し、--category フラグにマッピングされます：
usage — Olostepの機能を使用する：scrape、search、answers、crawl、map、batch、extract-schema。build — Olostepをコードベースにインストールして統合する：setup（MCPサーバーの設定）とintegrate（プロジェクトにOlostep SDKを追加）。workflow — Olostepで成果物を作成する：research、docs-to-code、migrate-code、debug-error。
1つのカテゴリーのみをインストール：
olostep add skills --category usage # コアウェブデータスキル
olostep add skills --category build # セットアップ＋統合スキル
olostep add skills --category workflow # リサーチ＋成果物スキル
ホストされたコピー
インストールされた各スキルは、https://www.olostep.com/skills/<name>/SKILL.md にホストされているコピーも参照します — ウェブアクセスを持つエージェントは最新バージョンを取得でき（インストール後に追加された機能を含む可能性があります）、そうでない場合はローカルコピーにフォールバックします。すべてのホストされたスキルはolostep.com/skillsで閲覧可能です。
インストール
npm install -g olostep-cli
# 検出されたすべてのエージェントに13スキルをインストール
olostep add skills
# またはスキルサブコマンド（エイリアス）を使用
olostep skills install
npx -y olostep-cli@latest add skills
一般的な使用法
# すべてのスキルをインストール
olostep skills install
# 最新に更新
olostep skills update
# インストールされているものとその場所を確認
olostep skills list
# すべてのスキルを削除
olostep skills uninstall
# コアウェブデータスキルのみ
olostep add skills --category usage
# セットアップ＋統合スキルのみ
olostep add skills --category build
# チェリーピック
olostep add skills --skill scrape --skill search --skill setup
# 特定のエージェントのみ
olostep add skills --agent cursor --agent claude
# 機械可読出力
olostep add skills --json
オプションリファレンス
| オプション | デフォルト | 説明 |
|---|
--login | — | インストール前にブラウザログインを実行 |
--source <path> | CLIバンドルスキル | スキルのソースディレクトリ |
--cli-local-dir <path> | CLI/skills | CLIローカル使用のためにソーススキルが同期されるディレクトリ |
--agent <name> | — | 特定のエージェントを対象に — 繰り返し可能 |
--all-agents / --no-all-agents | --all-agents | 検出されたすべてのエージェントを対象に |
--global / --no-global | --global | グローバルエージェントスキルディレクトリにインストール |
--canonical-dir <path> | ~/.agents/skills | 標準ストレージ場所 |
--agent-skills-dir <path> | — | カスタムターゲットディレクトリ（--no-globalが必要） |
--skill <name> | — | このスキルのみを含む — 繰り返し可能 |
--exclude <name> | — | このスキルを除外 — 繰り返し可能 |
--category | — | usage、build、またはworkflow |
--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出力形式
--json が渡された場合、出力は次のようになります：
{
"sync": {
"plugin_source_dir": "/path/to/CLI/skills",
"cli_local_dir": "/path/to/CLI/skills"
},
"selected_skills": ["scrape", "search"],
"canonical_dir": "~/.agents/skills",
"lockfile_path": "~/.agents/.skill-lock.json",
"installed": [
{
"skill": "scrape",
"canonical_path": "~/.agents/skills/olostep-scrape",
"targets": [
{ "agent": "cursor", "mode": "symlink", "path": "~/.cursor/skills/olostep-scrape" },
{ "agent": "claude", "mode": "symlink", "path": "~/.claude/skills/olostep-scrape" }
]
}
]
}
対応エージェント
| エージェント | キー |
|---|
| 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 list skills
どのスキルがインストールされ、どのエージェントにインストールされているかをファイルを掘り下げずに確認します。
olostep list skills # 人間が読めるサマリー
olostep list skills --json # 機械可読
olostep remove skills
Olostepがインストールしたスキルフォルダを標準ストアとエージェントスキルディレクトリから削除し、ロックファイルをクリーンアップします。
# すべてのエージェントからすべてのOlostepスキルを削除
olostep remove skills
# 特定のスキルを削除
olostep remove skills --skill research
# 特定のエージェントからのみ削除
olostep remove skills --agent cursor
# 機械可読なJSON出力
olostep remove skills --json
| オプション | デフォルト | 説明 |
|---|
--agent <name> | — | 指定されたエージェントからのみ削除 — 繰り返し可能 |
--all-agents / --no-all-agents | --all-agents | 検出されたすべてのエージェントを対象に |
--canonical-dir <path> | ~/.agents/skills | 削除する標準スキルディレクトリ |
--agent-skills-dir <path> | — | 削除のためのカスタムターゲットスキルディレクトリ |
--skill <name> | — | 一致するスキルのみを削除 — 繰り返し可能 |
--json | — | 機械可読なJSON出力 |
安全性: olostep- プレフィックスを持つフォルダのみが対象です。エージェントディレクトリ内の非Olostepスキルフォルダは変更されません。ロックファイルのクリーンアップは olostep- プレフィックスのキーのみを削除します。
スキルの発見と形式
スキルは SKILL.md ファイルを持つサブディレクトリをスキャンすることで発見されます。ファイルには name と description フィールドを含むYAMLフロントマターブロックが必要です。重複したサニタイズされた名前は拒否されます。
---
name: my-skill
description: このスキルが何をするか、そしていつ使用するか
---
# My Skill
...スキルの指示がここに...
命名規則
インストールされたフォルダは常に olostep- プレフィックスを使用します — 例：research は olostep-research になります。名前は小文字にサニタイズされ、無効な文字は - に置き換えられます。このプレフィックスは、Olostepが管理するスキルを明確に識別し、他のツールとの競合を防ぎます。
