> ## Documentation Index > Fetch the complete documentation index at: https://docs2.openclaw.ai/llms.txt > Use this file to discover all available pages before exploring further. # Skills の作成 Skills は、エージェントにツールをいつ、どのように使うかを教えます。各スキルは、 YAML フロントマターと Markdown の手順を含む `SKILL.md` ファイルを持つディレクトリです。 OpenClaw は、定義済みの[優先順位](/ja-JP/tools/skills#loading-order)に従って複数のルートから Skills を読み込みます。 ## 最初のスキルを作成する Skills はワークスペースの `skills/` フォルダーに配置します。 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} mkdir -p ~/.openclaw/workspace/skills/hello-world ``` 整理のためにスキルをサブフォルダーでグループ化できます。スキル名はフォルダーパスではなく、 `SKILL.md` のフロントマターで決まります。 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} mkdir -p ~/.openclaw/workspace/skills/personal/hello-world # skill name is still "hello-world", invoked as /hello-world ``` フロントマターはメタデータを定義し、本文はエージェントへの手順を示します。 ````markdown theme={"theme":{"light":"min-light","dark":"min-dark"}} --- name: hello-world description: A simple skill that prints a greeting. --- # Hello World When the user asks for a greeting, use the `exec` tool to run: ```bash echo "Hello from your custom skill!" ```` ```` 命名規則: - `name` には小文字、数字、ハイフンを使用します。 - ディレクトリ名とフロントマターの `name` を一致させます。 - `description` はエージェントとスラッシュコマンドの探索に表示されます。 1 行にし、160 文字未満にしてください。 ```bash openclaw skills list ```` OpenClaw はデフォルトで、Skills ルート配下の `SKILL.md` ファイルを監視します。 ウォッチャーが無効になっている場合、または既存のセッションを続けている場合は、 エージェントが更新済みリストを受け取れるように新しいセッションを開始します。 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # From chat — archive current session and start fresh /new # Or restart the gateway openclaw gateway restart ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw agent --message "give me a greeting" ``` またはチャットを開き、エージェントに直接依頼します。名前で明示的に呼び出すには `/skill hello-world` を使用します。 ## `SKILL.md` リファレンス ### 必須フィールド | フィールド | 説明 | | ------------- | ------------------------ | | `name` | 小文字、数字、ハイフンを使用する一意のスラッグ | | `description` | エージェントと探索出力に表示される 1 行の説明 | ### 任意のフロントマターキー | フィールド | デフォルト | 説明 | | -------------------------- | ------- | ---------------------------------------------------- | | `user-invocable` | `true` | スキルをユーザー向けスラッシュコマンドとして公開します | | `disable-model-invocation` | `false` | スキルをエージェントのシステムプロンプトから除外します（`/skill` 経由では引き続き実行されます） | | `command-dispatch` | — | `tool` に設定すると、モデルを迂回してスラッシュコマンドをツールへ直接ルーティングします | | `command-tool` | — | `command-dispatch: tool` が設定されているときに呼び出すツール名 | | `command-arg-mode` | `raw` | ツールディスパッチ時に、生の引数文字列をツールへ転送します | | `homepage` | — | macOS の Skills UI で「Website」として表示される URL | ゲート用フィールド（`requires.bins`、`requires.env` など）については [Skills — ゲート](/ja-JP/tools/skills#gating)を参照してください。 ### `{baseDir}` の使用 パスをハードコードせずに、スキルディレクトリ内のファイルを参照します。 エージェントは、スキル自身のディレクトリを基準に `{baseDir}` を解決します。 ```markdown theme={"theme":{"light":"min-light","dark":"min-dark"}} Run the helper script at `{baseDir}/scripts/run.sh`. ``` ## 条件付き有効化を追加する 依存関係が利用可能な場合にのみ読み込まれるように、スキルにゲートを設定します。 ```markdown theme={"theme":{"light":"min-light","dark":"min-dark"}} --- name: gemini-search description: Search using Gemini CLI. metadata: { "openclaw": { "requires": { "bins": ["gemini"] }, "primaryEnv": "GEMINI_API_KEY" } } --- ``` | キー | 説明 | | ------------------ | --------------------------------------------------- | | `requires.bins` | すべてのバイナリが `PATH` 上に存在する必要があります | | `requires.anyBins` | 少なくとも 1 つのバイナリが `PATH` 上に存在する必要があります | | `requires.env` | 各環境変数がプロセスまたは設定内に存在する必要があります | | `requires.config` | 各 `openclaw.json` パスが truthy である必要があります | | `os` | プラットフォームフィルター: `["darwin"]`、`["linux"]`、`["win32"]` | | `always` | `true` に設定すると、すべてのゲートをスキップし、常にスキルを含めます | 完全なリファレンス: [Skills — ゲート](/ja-JP/tools/skills#gating)。 `openclaw.json` のスキルエントリに API キーを接続します。 ```json5 theme={"theme":{"light":"min-light","dark":"min-dark"}} { skills: { entries: { "gemini-search": { enabled: true, apiKey: { source: "env", provider: "default", id: "GEMINI_API_KEY" }, }, }, }, } ``` キーは、そのエージェントターンに限ってホストプロセスへ注入されます。 サンドボックスには到達しません。詳しくは [サンドボックス化された環境変数](/ja-JP/tools/skills-config#sandboxed-skills-and-env-vars)を参照してください。 ## Skill Workshop 経由で提案する エージェントが下書きしたスキル、またはスキルを有効化する前にオペレーターのレビューを行いたい場合は、 `SKILL.md` を直接書く代わりに [Skill Workshop](/ja-JP/tools/skill-workshop) の提案を使用します。 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} # Propose a brand-new skill openclaw skills workshop propose-create \ --name "hello-world" \ --description "A simple skill that prints a greeting." \ --proposal ./PROPOSAL.md # Propose an update to an existing skill openclaw skills workshop propose-update hello-world \ --proposal ./PROPOSAL.md \ --description "Updated greeting skill" ``` 提案にサポートファイルが含まれる場合は `--proposal-dir` を使用します。 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw skills workshop propose-create \ --name "hello-world" \ --description "A simple skill that prints a greeting." \ --proposal-dir ./hello-world-proposal/ ``` ディレクトリのルートには `PROPOSAL.md` が含まれている必要があります。サポートファイルは `assets/`、`examples/`、`references/`、`scripts/`、または `templates/` の下に置きます。 レビュー後: ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} openclaw skills workshop inspect openclaw skills workshop apply ``` 提案ライフサイクル全体については [Skill Workshop](/ja-JP/tools/skill-workshop) を参照してください。 ## ClawHub へ公開する `name`、`description`、および任意の `metadata.openclaw` ゲートフィールドが設定されていることを確認します。 プロジェクトページがある場合は `homepage` URL を追加します。 ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} npm i -g clawhub clawhub login ``` ```bash theme={"theme":{"light":"min-light","dark":"min-dark"}} clawhub skill publish ./path/to/hello-world ``` 推定されたバージョンを上書きするには `--version ` を追加し、 特定の所有者の下で公開するには `--owner ` を追加します。完全なフロー、所有者スコープ、 その他のメンテナンスコマンド（`clawhub sync`、`clawhub skill rename` など）については、 [ClawHub — 公開](/ja-JP/clawhub/publishing) と [ClawHub CLI](/ja-JP/clawhub/cli) を参照してください。 ## ベストプラクティス * **簡潔にする** — AI としてどう振る舞うかではなく、モデルに*何を*するかを指示します。 * **安全を最優先にする** — スキルが `exec` を使用する場合、信頼できない入力から任意のコマンドインジェクションが発生しないようにプロンプトを設計します。 * **ローカルでテストする** — 共有する前に `openclaw agent --message "..."` を使用します。 * **ClawHub を使用する** — ゼロから構築する前に、[clawhub.ai](https://clawhub.ai) でコミュニティの Skills を確認します。 ## 関連 読み込み順序、ゲート、許可リスト、および SKILL.md 形式。 エージェントが下書きした Skills の提案キュー。 完全な `skills.*` 設定スキーマ。 公開レジストリで Skills を閲覧および公開します。 Plugins は、ドキュメント化するツールと一緒に Skills を同梱できます。