ひとことで言えば:スキルの導入は、要するに「スキルのフォルダを、AIツールが見つけられる場所に置く」ことです。 正確な場所はクライアントごとに異なります。最も一般的な3つの導入手段を紹介します。
導入前に知っておくこと:スキルは単なる「ファイル + フォルダ」です。プログラムの実行は不要で、ファイルをコピーする(または1コマンド実行する)だけで入ります。
方法①:Claude Code(CLI、最も一般的)
開発者にとってはClaude Codeが最も一般的なスキルのホストです。導入方法は2種類あります:
A. 他人のコレクションを導入する(コマンド1本)
/plugin marketplace add obra/superpowers ← スキルのマーケットを追加
/plugin install superpowers@workspace ← 現在のプロジェクトに導入(チームで共有)
/plugin install superpowers@user ← 自分のアカウントに導入(全プロジェクトで使用可)
Claude Codeの入力欄に(スラッシュ付きで)そのまま打ち込みます。導入後は自動で有効になります。
B. スキルのディレクトリを自前で置く
# プロジェクトに .claude/skills/ ディレクトリを作り、スキルフォルダを置く
my-project/
├── .claude/
│ └── skills/
│ └── my-skill/
│ ├── SKILL.md
│ └── scripts/
置いたらClaude Codeを再起動(または新しいセッションを開く)して、スキルを認識させます。
方法②:Claude Desktop(GUI)
- Claude Desktopを開く → Settings
- Developer セクションへ移動
- スキルディレクトリの設定を見つけ、ローカルのスキルフォルダの保存先ディレクトリを指定する(例:
~/skills) - スキルフォルダをそのディレクトリにコピー → Claude Desktopを再起動
画面はバージョンにより多少異なります。クライアントの「Skills」関連設定を目印にしてください。
方法③:Cursor / VS Code などのエディタ
- プロジェクトのルートで、各AIプラグインのスキルディレクトリの慣習に従う(Cursorの
.cursor/rules/、またはツール公式のスキルパスなど) - スキルフォルダをそのディレクトリに置く
- ウィンドウを再読み込み(
Ctrl+Shift+P → Reload Window)して有効化
各IDEのスキルディレクトリ慣習はバージョンごとに素早く変わります。導入がうまくいかないときは、まずプラグインの公式ドキュメントを確認してください。
よくある問題の解消
| 問題 | 原因 | 解決 |
|---|---|---|
| 導入後にAIが認識しない | 未再起動 / 新セッションを開いていない | 再起動。その前にディレクトリ名の綴りを確認 |
| スキルが発動しない | description の発動範囲が狭すぎる | よくある言い回しをすべて description に含める(執筆ガイド参照) |
| 「Marketplace not found」エラー | /plugin は一部バージョンのみ対応 | クライアントを更新するか、「手動でディレクトリに置く」方式を使う |
| スキルを削除したい | — | フォルダを削除するか、/plugin uninstall を実行 |
正しく入ったかの確認方法
- AIチャットに直接発動シーンを入力する。例「週報を書くのを手伝って」
- 出力がスキルの形式に従っているか確認(例:報告書が「成果 / 問題 / 計画」の3部構成になっているか)
- 発動しない場合は、ディレクトリパスと description を確認(最も多い2つのつまずきポイント)