Claude Skill Personal/Project区別(スキルパーソナル)
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 のスキル管理を個人用とプロジェクト用に分離し、効率的に再利用・共有できる仕組みです。
- Personal Skills は
~/.claude/commands/*.mdに保存し、日常的に使用するショートカットや好みのコーディングスタイル、API キーを管理します。 - Project Skills はプロジェクトルートに置かれる
.claude/commands/*.mdで、CI/CD ワークフローやアーキテクチャ規則、テストスイートを定義します。
2025年に、企業向けにスキル共有機能が標準化され、2026年には自動同期機能が実装されました。これにより、個人とチームの両方でスキルの整合性が保たれます。
主な特徴・仕組み
- ファイル構成
~/.claude/commands/*.md(Personal).claude/commands/*.md(Project)
- YAML Frontmatter で優先順位を設定(Project > Personal)
- Git 応用
- Personal は dotfiles リポジトリ(例:
$HOME/.dotfiles) - Project はプロジェクトリポジトリにコミット可能
- Personal は dotfiles リポジトリ(例:
- 自動同期
- 2026年のアップデートで、GitHub Actions 連携が標準化
- コーディングスタイル
- Personal で好みのフォーマッタを設定
- Project でチーム規約を強制
- API キー管理
- Personal はローカル環境変数
- Project は GitHub Secret で共有
- CLI コマンド
/loop,/todo,/note(Personal)/deploy,/test-suite,/code-review(Project)
- 優先順位ロジック
- 同名スキルは Project が上書き
- 2025年のトレンド
- スキルの可視化ダッシュボードが導入
- 2026年の動向
- AI アシスタントがスキルを自動生成する機能が追加
スペック比較表
| スキルタイプ | ストレージ | 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 |
自作PCでの選び方・注意点
- CPU とスキル処理
- スキルの実行は CPU 依存が高いので、Ryzen 9 9950X3D のようなマルチスレッド性能を重視。
- GPU のメモリ
- スキルで使用する画像処理や AI 推論には RTX 5090 の 24 GB GDDR7 が有利。
- メモリ帯域
- DDR5‑6000 で高速なデータロードを実現。
- ストレージ速度
- Samsung 990 Pro の NVMe 4.0 接続でスキルファイルの読み込みが速い。
- 電源容量
- 350 W TDP の RTX 5090 と 180 W TDP の Ryzen 9 9950X3D を組み合わせる場合、450 W 以上の電源が推奨。
- 冷却
- 高 TDP の構成は水冷や高性能エアクーラーで対策。
- OS とファイルシステム
- Ubuntu 24.04 LTS で
zfsを使用するとスキルファイルのスナップショットが容易。
- Ubuntu 24.04 LTS で
- セキュリティ
- Personal スキルに API キーを含める場合は
gpgで暗号化、Project では GitHub Secret を利用。
- Personal スキルに API キーを含める場合は
関連用語との違い
| 用語 | 定義 | 区別ポイント |
|---|---|---|
| dotfiles | ユーザー環境設定を Git で管理 | Personal Skill の保存場所 |
| CI/CD | 継続的インテグレーション/デリバリー | Project Skill で主に使用 |
| YAML Frontmatter | ファイル先頭のメタ情報 | スキルの優先順位決定に利用 |
| GitHub Actions | CI/CD 実行環境 | Project Skill で自動化に統合 |
よくある質問(FAQ)
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区別は、個人の作業効率とチーム全体のワークフローを同時に最適化できる仕組みです。
- Personal は日常のショートカットや好みの設定を、Project は CI/CD やアーキテクチャルールを管理。
- 2025 年に標準化された同期機能と 2026 年の自動生成機能により、スキルの整合性と再利用性が飛躍的に向上。
- 自作 PC では CPU、GPU、メモリ、ストレージの性能を総合的に評価し、スキル実行に最適な環境を構築してください。
この仕組みを活用すれば、個人作業のスピードアップとチーム開発の品質向上を同時に実現できます。