Claude Code YAML Frontmatter Reference

Skills、Agents（subagents）、Commands のYAML frontmatter完全リファレンス。

Skills (SKILL.md)

---
name: skill-name                    # 必須: 識別子（小文字、ハイフン）
description: Use when...            # 必須: いつ使うか（第三人称）
allowed-tools: Read, Grep, Glob     # 任意: 許可ツール（カンマ区切り）
model: inherit                      # 任意: inherit / 具体的モデル名
version: "1.0.0"                    # 任意: バージョン管理用
disable-model-invocation: false     # 任意: trueでSlash tool自動呼び出し禁止
mode: false                         # 任意: trueでMode Commandsセクション表示
---

| Property | Required | Values | |----------|----------|--------| | name | Yes | 小文字・ハイフンのみ | | description | Yes | "Use when..."形式推奨 | | allowed-tools | No | Read, Grep, Glob, Bash, Write, Edit, Task... | | model | No | inherit / claude-opus-4-20250514 等 | | version | No | セマンティックバージョン | | disable-model-invocation | No | true / false | | mode | No | true / false |

Agents (Subagents)

---
name: agent-name                    # 必須: 識別子
description: |                      # 必須: 説明（マルチライン可）
  Use when reviewing code...

  <example>
  user: "レビューして"
  assistant: "agent-nameで確認します"
  </example>
tools: Read, Grep, Glob, Bash       # 任意: 許可ツール（省略時は全継承）
model: sonnet                       # 任意: sonnet/opus/haiku/inherit
color: blue                         # 任意: 視覚識別用カラー
permissionMode: default             # 任意: 権限モード
skills: skill1, skill2              # 任意: 自動ロードするスキル
---

| Property | Required | Values | |----------|----------|--------| | name | Yes | 識別子 | | description | Yes | 説明（example付きマルチライン推奨） | | tools | No | カンマ区切り（省略=全ツール継承） | | model | No | sonnet / opus / haiku / inherit | | color | No | red / blue / green / yellow / purple / orange / pink / cyan | | permissionMode | No | default / acceptEdits / bypassPermissions / plan | | skills | No | カンマ区切りのスキル名 |

color について

公式ドキュメントには未記載だが /agents コマンドで生成される
ターミナルでsubagent呼び出し時に視覚的に識別可能

permissionMode 詳細

| Mode | 説明 | |------|------| | default | 通常の権限確認 | | acceptEdits | ファイル編集を自動承認 | | bypassPermissions | 全権限を自動承認（危険） | | plan | 読み取り専用、変更不可 |

Commands (Slash Commands)

---
description: コマンドの説明          # 推奨: SlashCommand toolで必要
argument-hint: [arg1] [arg2]        # 任意: 引数ヒント
allowed-tools: Bash(git:*), Read    # 任意: 許可ツール
model: claude-3-5-haiku-20241022    # 任意: 使用モデル
disable-model-invocation: true      # 任意: SlashCommand tool禁止
---

| Property | Required | Values | |----------|----------|--------| | description | Recommended | 説明文 | | argument-hint | No | [message], [file] [options] 等 | | allowed-tools | No | ツール制限（ワイルドカード可） | | model | No | 具体的なモデル名 | | disable-model-invocation | No | true / false |

Bash実行機能

allowed-toolsを指定すると、プロンプト内で ! プレフィックスでBash実行可能：

Current status: !`git status`

引数プレースホルダー

$ARGUMENTS - 全引数
$1, $2, $3... - 位置引数

配置場所

| Type | Project | User | Plugin | |------|---------|------|--------| | Skills | .claude/skills/ | ~/.claude/skills/ | skills/ | | Agents | .claude/agents/ | ~/.claude/agents/ | agents/ | | Commands | .claude/commands/ | ~/.claude/commands/ | commands/ |

優先順位: Project > User > Plugin

claude-code-frontmatter