カスタムコマンドとスキルの違いを知りたい

コマンド / 機能

.claude/commands/ と .claude/skills/ の統合

カスタムコマンドはスキルに統合された

概要

カスタムスラッシュコマンド（.claude/commands/*.md）は Agent Skills に統合されました。.claude/commands/deploy.md と .claude/skills/deploy/SKILL.md はどちらも同じ /deploy コマンドとして呼び出せます。既存の commands/ ディレクトリのファイルもそのまま動作し続けるため、移行は必須ではありません。スキルはディレクトリ構造を持てるため、対応するリソースファイル・frontmatter による呼び出し制御・サブエージェントとしての実行・動的なコンテキスト注入といった、単一 Markdown ファイルの commands/ にはない機能を追加で使えます。

設定例

# 従来のカスタムコマンド（引き続き動作する）
.claude/
  commands/
    deploy.md          # → /deploy

# スキル形式（同じ /deploy として呼び出せる）
.claude/
  skills/
    deploy/
      SKILL.md          # → /deploy
      scripts/
        run-deploy.sh    # スキル専用の付随ファイルを同梱できる
      templates/
        checklist.md

# SKILL.md 側でしか使えない機能の例
---
name: deploy
description: ステージング環境へのデプロイを実行
allowed-tools: Bash, Read
disable-model-invocation: false   # Claude による自動呼び出しの可否
context: fork                     # サブエージェントとして実行
---

公式ドキュメントを見る