Command を使うべきタイミング

結論

2026 年現在、新規はほぼ全部 Skill に統一して良い。command を選ぶ理由は2つだけ:

1. 既存の .claude/commands/*.md を保守している (移行コスト回避)
2. 1ファイルで完結し、付随ファイルが要らない 上に description を書きたくない

.claude/commands/foo.md も .claude/skills/foo/SKILL.md も同じく /foo を生やせる。違いは「ディレクトリが必要か」と「付随ファイル(scripts, refs)を持てるか」だけ。

command の最小例

---
description: GitHub の最新 issue を3件取得
---

最新 issue を3件 `gh issue list -L 3` で取得し、タイトル・番号・ラベル・作成日を表で返してください。

これだけで /<filename without .md> が使える。

ありがちな勘違い

• 「command は明示的にしか呼ばれない」 → 違う。description を書けば skill 同様に Claude が自動起動できる
• 「command の方が軽い」 → 起動コストは同等。差は付随ファイルだけ

移行戦略

既存 .claude/commands/*.md がある場合:

• 単発で良いもの → そのまま残す
• 付随スクリプト・テンプレを持たせたくなった → .claude/skills/<name>/SKILL.md に移す
• description チューニングで起動精度を上げたい → skill 化を検討

出典

• _research/claude-code-features/2026-05-11-claude-code-features.md
• https://code.claude.com/docs/en/commands