---
read_when:
    - ワークスペースで新しいカスタムスキルを作成しています
    - SKILL.md ベースの Skills 向けの簡単なスターターワークフローが必要です
summary: SKILL.md でカスタムワークスペース Skills をビルドしてテストする
title: Skills の作成
x-i18n:
    generated_at: "2026-05-10T19:54:11Z"
    model: gpt-5.5
    provider: openai
    source_hash: a468a0b21f4e43542b175b8acb8ad8b19dbbea06ce8e0b97c48206bf88a661c5
    source_path: tools/creating-skills.md
    workflow: 16
---

Skills は、エージェントがツールを使用する方法とタイミングを教えます。各 skill は、YAML frontmatter と markdown の手順を含む `SKILL.md` ファイルを持つディレクトリです。

skills の読み込み方法と優先順位については、[Skills](/ja-JP/tools/skills) を参照してください。

## 最初の skill を作成する

<Steps>
  <Step title="skill ディレクトリを作成する">
    Skills はワークスペース内にあります。新しいフォルダーを作成します。

    ```bash
    mkdir -p ~/.openclaw/workspace/skills/hello-world
    ```

  </Step>

  <Step title="SKILL.md を書く">
    そのディレクトリ内に `SKILL.md` を作成します。frontmatter はメタデータを定義し、markdown 本文にはエージェント向けの手順を記載します。

    ```markdown
    ---
    name: hello-world
    description: A simple skill that says hello.
    ---

    # Hello World Skill

    When the user asks for a greeting, use the `echo` tool to say
    "Hello from your custom skill!".
    ```

    skill の `name` には、小文字、数字、ハイフンを使ったハイフンケースを使用します。フォルダー名と frontmatter の `name` を一致させてください。

  </Step>

  <Step title="ツールを追加する（任意）">
    frontmatter でカスタムツールスキーマを定義することも、既存のシステムツール（`exec` や `browser` など）を使用するようエージェントに指示することもできます。Skills は、それらが文書化するツールと一緒に plugins 内に同梱することもできます。

  </Step>

  <Step title="skill を読み込む">
    OpenClaw が skill を検出できるよう、新しいセッションを開始します。

    ```bash
    # From chat
    /new

    # Or restart the gateway
    openclaw gateway restart
    ```

    skill が読み込まれたことを確認します。

    ```bash
    openclaw skills list
    ```

  </Step>

  <Step title="テストする">
    skill をトリガーするはずのメッセージを送信します。

    ```bash
    openclaw agent --message "give me a greeting"
    ```

    または、エージェントと通常どおりチャットして、挨拶を依頼します。

  </Step>
</Steps>

## skill メタデータのリファレンス

YAML frontmatter は以下のフィールドをサポートします。

| フィールド                          | 必須     | 説明                                                           |
| ----------------------------------- | -------- | -------------------------------------------------------------- |
| `name`                              | はい     | 小文字、数字、ハイフンを使用する一意の識別子                  |
| `description`                       | はい     | エージェントに表示される 1 行の説明                           |
| `metadata.openclaw.os`              | いいえ   | OS フィルター（`["darwin"]`、`["linux"]` など）                |
| `metadata.openclaw.requires.bins`   | いいえ   | PATH 上に必要なバイナリ                                       |
| `metadata.openclaw.requires.config` | いいえ   | 必要な設定キー                                                 |

## ベストプラクティス

- **簡潔にする** — AI としてどう振る舞うかではなく、_何を_ するかをモデルに指示します
- **安全性を優先する** — skill が `exec` を使用する場合、信頼できない入力から任意のコマンドインジェクションを許可しないプロンプトにしてください
- **ローカルでテストする** — 共有する前に `openclaw agent --message "..."` を使ってテストします
- **ClawHub を使う** — [ClawHub](https://clawhub.ai) で skills を閲覧し、貢献します

## skills の場所

| 場所                            | 優先順位 | スコープ              |
| ------------------------------- | ---------- | --------------------- |
| `\<workspace\>/skills/`         | 最高       | エージェントごと      |
| `\<workspace\>/.agents/skills/` | 高         | ワークスペースのエージェントごと |
| `~/.agents/skills/`             | 中         | 共有エージェントプロファイル |
| `~/.openclaw/skills/`           | 中         | 共有（すべてのエージェント） |
| OpenClaw に同梱                 | 低         | グローバル            |
| `skills.load.extraDirs`         | 最低       | カスタム共有フォルダー |

## 関連

- [Skills リファレンス](/ja-JP/tools/skills) — 読み込み、優先順位、ゲートルール
- [Skills 設定](/ja-JP/tools/skills-config) — `skills.*` 設定スキーマ
- [ClawHub](/ja-JP/clawhub) — 公開 skill レジストリ
- [Plugins の構築](/ja-JP/plugins/building-plugins) — plugins は skills を同梱できます