claude-code-frontmatter

Use when creating or editing Claude Code skills, agents (subagents), or slash commands. Provides complete YAML frontmatter property reference.

$ Installer

git clone https://github.com/ryugen04/dotfiles /tmp/dotfiles && cp -r /tmp/dotfiles/packages/claude/.claude/skills/claude-code-frontmatter ~/.claude/skills/dotfiles

// tip: Run this command in your terminal to install the skill

SKILL.md

View on GitHub →

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)

---
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