---

name: claude-code-frontmatter description: Use when creating or editing Claude Code skills, agents (subagents), or slash commands. Provides complete YAML frontmatter property reference.

Claude Code YAML Frontmatter Reference

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

Skills (SKILL.md)

Copy---
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セクション表示
---

Agents (Subagents)

Copy---
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              # 任意: 自動ロードするスキル
---

color について

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

permissionMode 詳細

Commands (Slash Commands)

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

Bash実行機能

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

CopyCurrent status: !`git status`

引数プレースホルダー

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

配置場所

優先順位: Project > User > Plugin

Sources

• Subagents - Claude Code Docs
• Agent Skills - Claude Code Docs
• Slash Commands - Claude Code Docs
• GitHub Issue #8501 - Frontmatter documentation
• Claude Agent Skills Deep Dive