메뉴
Claude Codeの拡張機構（CLAUDE.md / Skills / MCP）の使い分けガイド。 「CLAUDE.mdに書くべき？skillにすべき？」「MCPとskillの違いは？」「拡張したいけどどれで作る？」 「.claude/commandsと.claude/skillsの違い」「MCP serverはいつ使う？」 「常時適用ルールはどこに書く？」「コンテキスト効率を上げたい」などの判断に使う。 Claude Code自体の拡張設計の相談・レビュー時にも自動検出される。
기본적으로 소스를 먼저 확인하는 Prompt가 선택됩니다. 직접 명령으로 전환하거나 로컬 사본을 다운로드할 수도 있습니다.
설치 여부를 결정하기 전에 SKILL.md와 SkillsMP에 표시된 보조 파일을 읽어 보세요.
Codex 또는 Claude로 설치 이 Prompt를 복사해 Codex, Claude 또는 다른 어시스턴트에 붙여 넣으면 Skill 페이지를 검토하고 설치를 진행할 수 있습니다.
직접 명령은 검토 Prompt를 거치지 않습니다. 실행하기 전에 소스를 확인하세요.
npx skills add https://github.com/lilpacy/dotfiles --skill cc-extensibility-guide명령은 한 줄로 유지됩니다. 복사하기 전에 가로로 스크롤해 전체 내용을 확인하세요.
로컬 사본을 원하시나요? SkillsMP에서 현재 제공할 수 있는 파일을 다운로드하세요.
Compare an installed package, its release archive, and its source repository; distinguish source drift from runtime state; and backport verified installed-only fixes. Use when installed files or a ZIP were edited directly, or when the repository may be stale.
Maintain product, architecture, design, API, data, and operational documentation in an established repository. Use when deciding whether to edit an existing source of truth or add a document, separating current-state contracts from implementation plans, keeping volatile repository facts and technical debt out of reusable agent skills, moving content out of change-named documents, or reviewing documentation scope and placement.
Design, implement, and review CI test-result parsers, PR comments, job summaries, artifacts, and required checks. Use when cancelled or timed-out runs are misreported as test failures, setup/global errors disappear because zero tests ran, diagnostics may expose stacks or payloads, or workflow provenance limits what a run actually validates.
SOC 직업 분류 기준
SKILL.md 표시 중
| name | cc-extensibility-guide |
| description | Claude Codeの拡張機構（CLAUDE.md / Skills / MCP）の使い分けガイド。 「CLAUDE.mdに書くべき？skillにすべき？」「MCPとskillの違いは？」「拡張したいけどどれで作る？」 「.claude/commandsと.claude/skillsの違い」「MCP serverはいつ使う？」 「常時適用ルールはどこに書く？」「コンテキスト効率を上げたい」などの判断に使う。 Claude Code自体の拡張設計の相談・レビュー時にも自動検出される。 |
CLAUDE.md（基盤知識層・常時読み込み）
→ Skills/Commands（手順・タスク層・オンデマンド）
→ MCP（外部接続層・ステートフル通信）
ここが最も混乱しやすいポイント。どちらも「Claudeに知識を与える」点は同じ。
CLAUDE.mdにあらゆる知識を詰め込むとコンテキストを無駄に消費する。特定場面でしか使わない知識はSkillに分離する。
CLAUDE.mdが大きくなったら .claude/rules/*.md でトピック別に分割可能（paths frontmatterで適用範囲も絞れる）。
| 機能 | CLAUDE.md | Skills | MCP |
|---|---|---|---|
| 常時読み込み | o | x（オンデマンド） | x（ツール定義のみ常時） |
手動呼び出し (/name) | x | o | x |
| Claude自動検出・呼び出し | 不要（常時） | o | o（ツールとして） |
| 支援ファイル (templates等) | x（rules/で分割のみ） | o | x |
サブエージェント実行 (context: fork) | x | o | x |
| 外部API/DB/サービス通信 | x | x | o |
| ステートフル接続 | x | x | o |
| 認証 (OAuth等) | x | x | o |
常に適用したいルール？ → Yes → CLAUDE.md / rules
↓ No
外部通信が必要？ → Yes → MCP Server
↓ No
複数参照ファイル or 自動検出 or サブエージェント分離？ → Yes → Skill
↓ No
新規作成？ → Skill（Commandsより常にSkillを選ぶ）
既存Commands？ → そのまま動く。移行は必要になった時でよい
3層は排他ではなく補完関係。
| ユースケース | CLAUDE.md | Skill | MCP |
|---|---|---|---|
| Figmaデザイン実装 | React規約・命名規則 | /implement-design（変換手順） | figma-remote-mcp（API） |
| コードレビュー+コミット | テスト方針・lint設定 | /claude-review（レビュー観点） | 不要 |
| 画像生成 | — | /nanobanana-prompt-writer（プロンプト知識） | nanobanana（Gemini API） |
| 状況 | 選択 |
|---|---|
| 全セッションで常に適用したいルール・知識 | CLAUDE.md |
| 外部サービスとの通信が必要 | MCP |
| 特定の作業文脈での知識・手順 + 自動検出 | Skill |
| 単純な定型手順（既存） | Command（そのまま） |
| 新規作成 | 常にSkill |