Claude Code にスキルをインストールする方法：Mac と Windows のスキルのフォルダー

Mac と Windows のスキルのフォルダー

Claude Code のドキュメントの日本語版から、2026 年 11 月 6 日に確認。個人とプロジェクトに同じ名前のスキルがあれば、個人のほうが動きます。%USERPROFILE% はふつう C:\Users\<ユーザー名> です（Microsoft）。CLAUDE_CONFIG_DIR を設定しているなら、フォルダーはその下になります。

もらったスキルを入れる

ダウンロードのフォルダーに、すぐ下に SKILL.md がある pr-description というフォルダーがあるとします。ZIP で届いたなら、先に解凍しておきます。

Mac・Linux はターミナルで：

mkdir -p ~/.claude/skills
cp -R ~/Downloads/pr-description ~/.claude/skills/

Windows は PowerShell で。$HOME が %USERPROFILE% のフォルダーを指します。

New-Item -ItemType Directory -Path "$HOME\.claude\skills" -Force
Copy-Item -Path "$HOME\Downloads\pr-description" -Destination "$HOME\.claude\skills" -Recurse -Force

-Path には、すぐ下に SKILL.md があるフォルダーを指定します。Windows の［すべて抽出］は、ZIP の中のフォルダーを 1 段深く、Downloads\pr-description\pr-description に展開することがあります。SKILL.md がその中にあれば、内側のフォルダーをコピーします。コピー先を skills のフォルダーそのものにしているので、Copy-Item はフォルダーの名前を保ちます（Microsoft：元のフォルダーの名前を残すには、既存のフォルダーにコピーする）。-Force をつけているので、新しい版を入れ直すときも、同じコマンドで古いファイルに上書きできます。

チーム全員で使うなら、代わりにリポジトリの .claude/skills/ にコピーしてコミットします。プルした人から使えるようになります。

入れたら Claude Code で /skills を打ちます。セッションを始めたときに skills のフォルダーがまだなかったなら、先に /reload-skills を実行し、そのセッションでそこを変えるたびにもう一度実行します。

スキルが Claude Code に入る、ほかの 2 つの道

• claude.ai のアカウントから。Claude のカスタマイズ > スキルでオンにしたスキルは、Claude Code に同じ claude.ai のアカウントでサインインすると読み込まれます（バージョン 2.1.273 以降）。~/.claude/skills/synced/ にダウンロードされ、/skills の「claude.ai sync」に並びます。直すのは claude.ai で。このフォルダーで直しても、あとの同期で上書きされることがあります。API キーや Amazon Bedrock などのクラウドプロバイダーでは同期しません。
• プラグインとして。スキルが GitHub のプラグインのマーケットプレイスとして配られているなら、/plugin marketplace add owner/repo のあと /plugin install <plugin>@<marketplace> を実行します。Claude のカスタマイズ > プラグインで一度追加すれば、同じアカウントでサインインした Claude Code にも同期されます。スキルは /<plugin>:<skill> で動きます。2 種類のリポジトリの入れ方は GitHub の Claude スキルを入れる方法で説明しています。

Claude のデスクトップアプリも同じで、アプリの中の Claude Code のローカルセッションは ~/.claude/skills/ を読みます。同じアプリの Cowork は読まず、claude.ai のアカウントのスキルを使います。

入れたのに Claude Code の一覧に出ないとき

• フォルダーが 1 段深い。Claude Code が読むのは skills/<skill-name>/SKILL.md です。skills/pr-description/pr-description/SKILL.md になっていたら、解凍したダウンロードの外側のフォルダーをコピーしています。内側のフォルダーを 1 段上に移します。
• 予約された名前。synced という名前のフォルダーは読み飛ばされます。Claude Code が claude.ai から取ってくるスキル用の名前です。

一覧には出るのに使われない、などほかの原因は、Claude のスキルが表示されない・使われないときの直し方に Claude Code と claude.ai の確かめ方があります。

例：1 つのスキルを、Mac と Windows のノートパソコンに

架空の例です。美咲さんと拓也さんは、ふたりでお客さまのウェブサイトを作っています。美咲さんは Mac、拓也さんは Windows で、どちらも Claude Code を使います。プルリクエストを出す前に、美咲さんはいつもこう貼り付けます。

この差分から PR の説明を書いて。何をなぜ変えたかを 2 文で、実際に走らせたテストのコマンドを「テスト」の節に、リスクを 1 行で。データベースのマイグレーションがあれば最初に書く。宣伝っぽい言葉は使わない。

言い直すのはいつも「テストのコマンドを作らないで。わたしに聞いて」。両方を「プロンプトをスキルにする」スキルに渡すと、次のように始まる SKILL.md が返ってきます。

---
name: pr-description
description: 差分からプルリクエストの説明を書く。何をなぜ変えたか、実際に走らせたテストのコマンド、リスクを書き、マイグレーションがあれば最初に置く。PR の説明、PR のまとめ、「この PR を書いて」と頼まれたときに使う。
---

## 手順
1. 差分を読む。マイグレーションを足すか変えるなら、
   「マイグレーション：」と対象のテーブルから始める。
2. 何をなぜ：2 文で。宣伝の言葉は使わない。
3. テスト：ユーザーが示したコマンドだけを書く。なければ聞く。
...

1. 美咲さんは ~/.claude/skills/pr-description/SKILL.md として保存します。/skills にすぐ出ます。
2. 拓也さんはチャットで届いたフォルダーをダウンロードに保存し、上の PowerShell の 2 行を実行します。/skills に出ます。
3. 1 週間後、美咲さんが「チケットのリンクを貼る」を足します。拓也さんのコピーは変わりません。ふたりはフォルダーをお客さまのリポジトリの .claude/skills/ に移してコミットし、プルすれば両方が新しくなるようにします。

ふたりのぶんはリポジトリで片づきました。それでも、ブラウザで Claude を使うお客さまのプロジェクトマネージャーには届きません。

次の一歩：フォルダーをコピーするより、チームのポッドを 1 回

コピーしたフォルダーは 1 台のパソコンにしかなく、コミットしたフォルダーはそのリポジトリで働く人にしか届きません。チーム全体に届ける方法は Claude スキルを GitHub で共有する方法で比べています。スキルを自分で書くなら、SKILL.md そのものは Claude Code でスキルを作る方法で説明しています。

AI Skill Pod（このサイトの製品）なら、AI スキルを、チームでかんたん共有。無料で始められます。チームのポッドを各自が 1 回だけ追加します。Claude Code では claude mcp add --transport http とポッドのリンクで、Claude、Cursor、ChatGPT（Pro・Business・Enterprise）ではコネクタとして。これで全員が同じスキルを使え、直した内容は、次にそれぞれの AI がスキルを取りにいったときに全員に届きます。ポッドのスキルは /skills には出ず、Claude Code は仕事が合ったとき、または名前で頼まれたときに、ポッドから取りにいきます。Free は 3 人・スキル 10 個までです。

よくある質問

Windows で Claude Code のスキルを入れるフォルダーはどこ？

%USERPROFILE%\.claude\skills\ で、ふつうは C:\Users\<ユーザー名>\.claude\skills\ です。Claude Code のドキュメントに、Windows では ~/.claude が %USERPROFILE%\.claude になるとあります。スキルごとにフォルダーを作り、その中に SKILL.md を置きます。リポジトリのスキルは、Mac と同じくその .claude/skills に置きます。

Mac で Claude Code のスキルを入れるフォルダーはどこ？

すべてのプロジェクトで使うなら ~/.claude/skills/<skill-name>/SKILL.md、リポジトリの全員で使うならそのリポジトリの .claude/skills/<skill-name>/SKILL.md です。このページのターミナルのコマンドで、フォルダーを作ってスキルをコピーできます。

Windows で解凍してから入れたのに、スキルが一覧に出ないのはなぜ？

［すべて抽出］が ZIP の中のフォルダーを 1 段深く展開し、skills\pr-description\pr-description\SKILL.md になっていることがあります。Claude Code が読むのは skills\<skill-name>\SKILL.md だけです。すぐ下に SKILL.md がある内側のフォルダーを %USERPROFILE%\.claude\skills にコピーし、/skills で確かめます。

claude.ai でアップロードしたスキルは Claude Code でも使える？

使えます。Claude Code に同じ claude.ai のアカウントでサインインすると（Claude Code v2.1.273 以降）、~/.claude/skills/synced/ にダウンロードされ、/skills の「claude.ai sync」に並びます。API キーでサインインしたときや、クラウドプロバイダー経由で動かしているときは同期されません。