> ## Documentation Index
> Fetch the complete documentation index at: https://docs.olostep.com/llms.txt
> Use this file to discover all available pages before exploring further.

# スキル

> AIコーディングエージェントにOlostepスキルをインストールして管理する

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

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

この機能は[Olostep CLI](/sdks/cli)を通じて利用可能です。

## スキル

`olostep add skills` は全13スキルをインストールします。各スキルはエージェントがOlostepが**何を**できるか、そして**いつ**使うべきかを知るために読む `SKILL.md` です。

スキルは[MCPサーバー](/integrations/mcp-server)と連携します：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つのカテゴリーのみをインストール：

```bash theme={null}
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](https://www.olostep.com/skills/index.md)で閲覧可能です。

## インストール

```bash theme={null}
npm install -g olostep-cli

# 検出されたすべてのエージェントに13スキルをインストール
olostep add skills

# またはスキルサブコマンド（エイリアス）を使用
olostep skills install
```

CLIをインストールせずに：

```bash theme={null}
npx -y olostep-cli@latest add skills
```

## 一般的な使用法

```bash theme={null}
# すべてのスキルをインストール
olostep skills install

# 最新に更新
olostep skills update

# インストールされているものとその場所を確認
olostep skills list

# すべてのスキルを削除
olostep skills uninstall
```

インストールするものをフィルタリング：

```bash theme={null}
# コアウェブデータスキルのみ
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出力                          |

<Note>
  **検証ルール:**

  * `--link-mode` は `auto`、`symlink`、または `copy` でなければなりません
  * `--agent-skills-dir` は `--no-global` を必要とします
  * `--no-global` は `--agent-skills-dir` を必要とします
  * 不明なエージェント名はエラーになります
  * `--skill` / `--exclude` 後のスキル選択が空の場合はエラーになります
</Note>

### JSON出力形式

`--json` が渡された場合、出力は次のようになります：

```json theme={null}
{
  "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`

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

```bash theme={null}
olostep list skills            # 人間が読めるサマリー
olostep list skills --json     # 機械可読
```

## `olostep remove skills`

Olostepがインストールしたスキルフォルダを標準ストアとエージェントスキルディレクトリから削除し、ロックファイルをクリーンアップします。

```bash theme={null}
# すべてのエージェントからすべての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出力                |

<Note>
  **安全性:** `olostep-` プレフィックスを持つフォルダのみが対象です。エージェントディレクトリ内の非Olostepスキルフォルダは変更されません。ロックファイルのクリーンアップは `olostep-` プレフィックスのキーのみを削除します。
</Note>

## スキルの発見と形式

スキルは `SKILL.md` ファイルを持つサブディレクトリをスキャンすることで発見されます。ファイルには `name` と `description` フィールドを含むYAMLフロントマターブロックが必要です。重複したサニタイズされた名前は拒否されます。

```markdown theme={null}
---
name: my-skill
description: このスキルが何をするか、そしていつ使用するか
---

# My Skill

...スキルの指示がここに...
```

## 命名規則

インストールされたフォルダは常に `olostep-` プレフィックスを使用します — 例：`research` は `olostep-research` になります。名前は小文字にサニタイズされ、無効な文字は `-` に置き換えられます。このプレフィックスは、Olostepが管理するスキルを明確に識別し、他のツールとの競合を防ぎます。

## 関連

* [CLIリファレンス](/sdks/cli) — コマンドの完全なドキュメント
* [MCPサーバー](/integrations/mcp-server) — エージェントにライブのOlostepツールを提供