Claude Code Skill scope。Personal Skills(~/.claude/commands/*.md)・全project共通使用・Personal preferences(coding style/tone)・gitignore対象・他PC同期: dotfiles管理(GitHub repo $HOME/.dotfiles bash setup)・Project Skills(.claude/commands/*.md・project root)・project local・git commit可能・チーム共有・project specific workflows・両方YAML frontmatter同format・priority: project skill > personal skill同名時・use case: Personal = Daily quick commands/Personal style/Personal API key・Project = Team workflow/Architecture rules/CI integration・例: Personal /loop /todo /note・Project /deploy /test-suite /code-review・2026年 双方使い分け確立。
Claude Skill Personal/Project区別は、Claude AI のスキル管理を個人用とプロジェクト用に分離し、効率的に再利用・共有できる仕組みです。
~/.claude/commands/*.md に保存し、日常的に使用するショートカットや好みのコーディングスタイル、API キーを管理します。.claude/commands/*.md で、CI/CD ワークフローやアーキテクチャ規則、テストスイートを定義します。~/.claude/commands/*.md（Personal）.claude/commands/*.md（Project）$HOME/.dotfiles）/loop, /todo, /note（Personal）/deploy, /test-suite, /code-review（Project）| スキルタイプ | ストレージ | Git 同期 | 優先度 | 共同作業 | 主な用途 |
|---|---|---|---|---|---|
| Personal | 512 MB/ファイル | dotfiles リポジトリ | 低 | 個人 | 日常コマンド・スタイル |
| Project | 1 GB/リポジトリ | プロジェクトリポジトリ | 高 | チーム | CI/CD・ワークフロー |
| 製品 | スキル適用例 | 数値スペック |
|---|---|---|
| RTX 5090 | 高解像度ゲーム最適化スクリプト | 24 GB GDDR7, 350 W TDP |
| Ryzen 9 9950X3D | マルチスレッドビルドスクリプト | 16 コア/32 スレッド, 180 W TDP |
| DDR5‑6000 | メモリプロファイル設定 | 64 GB, 6000 MHz |
| Intel Core i9‑13900K | デバッグスクリプト | 24 コア/32 スレッド, 250 W TDP |
| Samsung 990 Pro | ストレージ最適化スクリプト | 4 TB, NVMe 4.0 |
zfs を使用するとスキルファイルのスナップショットが容易。gpg で暗号化、Project では GitHub Secret を利用。| 用語 | 定義 | 区別ポイント |
|---|---|---|
| dotfiles | ユーザー環境設定を Git で管理 | Personal Skill の保存場所 |
| CI/CD | 継続的インテグレーション/デリバリー | Project Skill で主に使用 |
| YAML Frontmatter | ファイル先頭のメタ情報 | スキルの優先順位決定に利用 |
| GitHub Actions | CI/CD 実行環境 | Project Skill で自動化に統合 |
Q1. Personal Skill と Project Skill のファイルサイズに上限はありますか？
A1. Personal Skill は通常 512 MB 以下に抑えることを推奨します。Project Skill はプロジェクト全体の 1 GB を超えないように管理し、過剰なデータは別リポジトリへ分離してください。
Q2. 2025 年以降のスキル同期機能はどのように動作しますか？
A2. 2025 年に導入された自動同期機能は、GitHub Actions で claude-sync スクリプトを走らせ、Personal と Project の両リポジトリを定期的にマージします。同期失敗時は通知が Slack へ送信されます。
Q3. 共同作業時に同名のスキルが衝突した場合、どちらが優先されますか？
A3. Project Skill が Personal Skill を上書きします。衝突を避けるには、スキル名に personal/ や project/ のプレフィックスを付与するのが安全です。
Claude Skill Personal/Project区別は、個人の作業効率とチーム全体のワークフローを同時に最適化できる仕組みです。