0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?

Claudeの CLAUDE.md / Skills / Slash Commands / Plugins 整理

0
Posted at

保存場所・フォルダ構造まで含めて整理する

Claude には似た概念が複数あり、
**「何が違うか」だけでなく「どこに置くのか」**が分からないと一気に混乱します。

この記事では、

  • 役割の違い
  • 保存場所
  • フォルダ構造
  • グローバル / プロジェクトスコープ

まで含めて整理します。


全体像(まずは俯瞰)

~/.claude/
├─ CLAUDE.md            # グローバルなデフォルト指示
├─ skills/
│  └─ my-skill.md
├─ commands/
│  └─ my-command.md
└─ plugins/
   └─ frontend-design/
      ├─ plugin.json
      └─ skills/
         └─ design-review.md

プロジェクトごとに使う場合は、以下のようにリポジトリ内に置きます。

./
├─ CLAUDE.md            # プロジェクト専用の前提知識
├─ .claude/
│  ├─ skills/
│  ├─ commands/
│  └─ plugins/
└─ src/

CLAUDE.md:常に読み込まれる前提知識

保存場所

スコープ パス
グローバル ~/.claude/CLAUDE.md
プロジェクト ./CLAUDE.md

特徴

  • すべての会話の冒頭に必ず読み込まれる
  • 何もしなくても自動で適用される

向いている内容

  • プロジェクト概要
  • 技術スタック
  • コーディング規約
  • 前提条件(言語、フレームワーク、思想)

このプロジェクトはLaravel + Reactで構築されている。
コード例はTypeScriptを優先する。

Skills:必要なときだけ読み込まれる指示

保存場所

スコープ パス
グローバル ~/.claude/skills/
プロジェクト ./.claude/skills/

構造例

skills/
├─ translate-pronunciation.md
├─ code-review.md
└─ api-design.md

特徴

  • Claude が自動的に呼び出す
  • ユーザーが /skill-name で手動実行も可能
  • 必要なときだけロードされる(トークン効率が良い)

向いている内容

  • 特定条件で実行したい処理
  • 再利用可能な作業手順
  • 定型アウトプット(レビュー、変換、補助作業)

Slash Commands:ユーザーが明示的に実行する指示

保存場所

スコープ パス
グローバル ~/.claude/commands/
プロジェクト ./.claude/commands/

構造例

commands/
├─ summarize.md
├─ generate-tests.md
└─ refactor.md

特徴

  • /summarize のようにユーザーが実行
  • Claude からも呼び出せる
  • タイミングと意図を完全に制御できる

向いている内容

  • 手動トリガーしたい処理
  • 1回限り or 明示的な作業
  • 「今この処理をしてほしい」が明確なケース

Skills と Slash Commands の使い分け

観点 Skills Slash Commands
主体 Claude ユーザー
実行 自動 / 手動 手動中心
用途 裏側の知識・補助 操作コマンド

設計思想の違いであり、
機能的にはかなり近いため将来的に統合される可能性も高そうです。


Plugins:まとめて配布・インストールする単位

保存場所

~/.claude/plugins/

または

./.claude/plugins/

構造例

plugins/frontend-design/
├─ plugin.json
├─ skills/
│  └─ design-review.md
├─ commands/
│  └─ ui-check.md
└─ agents/

特徴

  • Skills / Commands / Agents などをまとめられる
  • 必ず全部入れる必要はない
  • インストール・共有が容易

Anthropic公式の frontend-design プラグインは
実態としては Skill 1つだけで構成されている


実務的な設計指針(おすすめ)

  • CLAUDE.md は最小限
  • 条件付き処理は Skills に逃がす
  • 明示操作は Slash Commands
  • チーム共有は Plugins 化

まとめ

Claude の設定は、
「何を書くか」より 「どこに置くか」 が設計の8割です。

フォルダ構造を意識すると、

  • トークン効率
  • 再利用性
  • チーム共有

すべてが一段上がります。

0
1
0

Register as a new user and use Qiita more conveniently

  1. You get articles that match your needs
  2. You can efficiently read back useful information
  3. You can use dark theme
What you can do with signing up
0
1

Delete article

Deleted articles cannot be recovered.

Draft of this article would be also deleted.

Are you sure you want to delete this article?