FreeAILab free-ai-lab

スキルのインストール

チュートリアル

3つの導入手段——Claude Code / Claude Desktop / Cursor——と、エラーの解消。

ひとことで言えば:スキルの導入は、要するに「スキルのフォルダを、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)

  1. Claude Desktopを開く → Settings
  2. Developer セクションへ移動
  3. スキルディレクトリの設定を見つけ、ローカルのスキルフォルダの保存先ディレクトリを指定する(例:~/skills)
  4. スキルフォルダをそのディレクトリにコピー → Claude Desktopを再起動

画面はバージョンにより多少異なります。クライアントの「Skills」関連設定を目印にしてください。

方法③:Cursor / VS Code などのエディタ

  1. プロジェクトのルートで、各AIプラグインのスキルディレクトリの慣習に従う(Cursorの .cursor/rules/、またはツール公式のスキルパスなど)
  2. スキルフォルダをそのディレクトリに置く
  3. ウィンドウを再読み込み(Ctrl+Shift+P → Reload Window)して有効化

各IDEのスキルディレクトリ慣習はバージョンごとに素早く変わります。導入がうまくいかないときは、まずプラグインの公式ドキュメントを確認してください。

よくある問題の解消

問題 原因 解決
導入後にAIが認識しない未再起動 / 新セッションを開いていない再起動。その前にディレクトリ名の綴りを確認
スキルが発動しないdescription の発動範囲が狭すぎるよくある言い回しをすべて description に含める(執筆ガイド参照)
「Marketplace not found」エラー/plugin は一部バージョンのみ対応クライアントを更新するか、「手動でディレクトリに置く」方式を使う
スキルを削除したい—フォルダを削除するか、/plugin uninstall を実行

正しく入ったかの確認方法

  1. AIチャットに直接発動シーンを入力する。例「週報を書くのを手伝って」
  2. 出力がスキルの形式に従っているか確認(例:報告書が「成果 / 問題 / 計画」の3部構成になっているか)
  3. 発動しない場合は、ディレクトリパスと description を確認(最も多い2つのつまずきポイント)

さらに読む