月額 $9.99 ですべての Premium Skill にアクセス。いつでも解約できます。プランを見る

Claude Code Skills：追加・使い方・トラブル対処

Claude Code は ~/.claude/skills/ から Skill を読み込みます。「インストールしたのに何も起きない」というケースの多くは、Skill が別の場所に置かれていることが原因です。Skillry から Skill を追加し、スラッシュコマンドとして実行し、いつ動くかを制御する方法を解説します。

対象
Claude Code のユーザー
所要時間
8 分で完了

結論から

  1. 1すべてのプロジェクトで使うなら Skill のフォルダを ~/.claude/skills/ に、1 つのリポジトリだけで使うなら .claude/skills/ に置きます。
  2. 2Skillry CLI でインストールする場合は --agent claude-code を付けます。付けないと Skill は ~/.agents/skills/ に入り、Claude Code はそこを読み込みません。
  3. 3/skills と入力して存在を確認し、/skill-name に続けて依頼を入力して実行します。
  4. 4すぐに使えるものがほしいなら、コマンド 1 つでインストールできる Claude Code Skills をご覧ください。
ここから始める：Skill を追加する読み込む場所うまく動かない

Claude Code に Skill を追加する方法

インストール用プロンプトを Claude Code に貼り付ける、Skillry CLI を自分で実行する、フォルダを手動でコピーする、のいずれかの方法があります。どの方法でも、最終的には Skill のフォルダが ~/.claude/skills/ の中に置かれます。

見落としがちなフラグ

Skillry CLI は、Codex と Cursor がどちらも読み込む ~/.agents/skills/ にデフォルトでインストールします。Claude Code が読み込むのは専用の ~/.claude/skills/ です。--agent claude-code を付け忘れてもインストールは成功と表示されますが、Claude Code からその Skill は見えません。

Claude Code をすでに開いているなら最も簡単
  1. 1

    Skillry で Skill を開き、インストール用プロンプトをコピー を選んでから、ダイアログで コピー を選びます。

  2. 2

    Claude Code に貼り付けて送信します。エージェントが Skillry のインストール手順を読み、適切なコマンドを自分で実行します。

    インストール用プロンプト
    Read https://skillry.dev/skills/<slug>/install.md and follow the instructions to install the skill.
  3. 3

    ブラウザでデバイスコードの承認を求められたら、承認します。

    表示されるはずのもの： Claude Code が、インストールしたバージョンと、~/.claude/skills/ 配下の使用したフォルダを報告します。

Skillry Skill page for Notion Style OG Image with the Copy install prompt and Download ZIP buttons
Skillry のすべての Skill ページにある 2 つのインストール方法。

Claude Code から見えているか確認する

/skills と入力します。一覧には、あなたの Skill に加えて、/code-review など Claude Code に同梱されている Skill がいくつか表示されます。t を押すと、コンテキストの消費量順に並べ替えられます。

再起動は不要です。Claude Code は、新しい Skill や編集した Skill を現在のセッションで認識します。唯一の例外として、セッション開始時に ~/.claude/skills/ が存在しなかった場合は、/reload-skills を一度実行してください。

Skill を Claude Code のスラッシュコマンドとして実行する

インストールした Skill は、すべて Skill の名前のスラッシュコマンドとして表示されます。コマンドを入力し、同じ行でやりたいことを伝えましょう：

Claude Code
/launch-page Parcelo, a parcel-tracking dashboard for small online shops

名前の後に書いた内容はすべて、$ARGUMENTS として Skill に渡されます。一度動作を確認できれば、たいていはコマンドを省略し、普通の言葉でタスクを説明するだけで済みます。依頼が Skill の description に一致すると、Claude は自動で Skill を読み込みます。良い結果を得るコツは Skill の使い方で詳しく解説しています。

Claude Code が Skill を探す場所と、優先されるコピー

Claude Code は 5 つの場所から Skill を集めます。ほとんどの人が使うのは個人用とプロジェクト用のフォルダだけで、ほかはチームで使うときやプラグインをインストールしたときに関係してきます。

ソース場所コマンド
Enterprise管理設定/skill-name
個人~/.claude/skills/<name>//skill-name
プロジェクト.claude/skills/<name>//skill-name
プラグイン<plugin>/skills/<name>//plugin-name:skill-name
claude.ai アカウント~/.claude/skills/synced/ に同期/name または /anthropic-skills:name

同じ名前が 2 か所にある場合、Enterprise が個人より、個人がプロジェクトより優先されます。サブフォルダの .claude/skills/ にある Skill は、Claude がそのサブフォルダのファイルを初めて扱ったときに読み込まれます。そのため、大きなリポジトリ内の特定パッケージ向けの Skill は、必要になるまで邪魔になりません。

いつ動くかを制御する SKILL.md の設定

これらのフィールドは SKILL.md の先頭にある frontmatter に書きます。必要になるのは、Skill が動きすぎる、動かなさすぎる、あるいは毎ステップで許可を求めて止まる場合だけです。

SKILL.md のフィールド効果
descriptionClaude が Skill を使うかどうかを判断するために読む内容。when_to_use と合わせて、Skill 一覧では 1,536 文字で切り詰められます。
allowed-toolsSkill を呼び出したターンの間、Claude が確認なしで使えるツール。
pathsファイルパターン。一致するファイルを扱っているときだけ、Claude が Skill を自動で読み込みます。

Claude Code の Skill が動かない？まずここを確認

上から順に確認してください。最初の行の「Skill が間違ったフォルダにある」が最もよくある原因です。

/skills に表示されない

フォルダが間違っているか、ZIP で階層が増えています。パスが ~/.claude/skills/<name>/SKILL.md になるよう移動するか、--agent claude-code を付けて再インストールします。

フォルダを新しく作った

/reload-skills を実行します。

クラウドセッションに表示されない

リポジトリの .claude/skills/ にコミットするか、claude.ai で有効にします。

Cowork に表示されない

claude.ai アカウントで有効にします。

一覧にはあるが、選ばれない

/name で呼び出して動作を確認し、description をより具体的にします。トリガーの仕組みをご覧ください。

それ以外のケースはトラブルシューティングで解説しています。

よくある質問

Claude Code で Skill は使えますか？

使えます。Claude Code はオープンな Agent Skills 標準に準拠しており、個人用フォルダ、現在のプロジェクト、プラグイン、組織、claude.ai アカウントから Skill を読み込みます。

Claude Code の Skill はどこに保存されますか？

自分用の Skill は ~/.claude/skills/<name>/SKILL.md に、特定のプロジェクト用の Skill はそのリポジトリ内の .claude/skills/<name>/SKILL.md に置きます。

カスタムスラッシュコマンドはどうなったのですか？

引き続き使えます。.claude/commands/deploy.md のファイルも、deploy という名前の Skill も、どちらも /deploy になります。両方ある場合は Skill が優先されます。

Skillry CLI に --agent claude-code が必要なのはなぜですか？

CLI のデフォルトのフォルダは、Codex と Cursor が共有する ~/.agents/skills/ です。Claude Code は代わりに ~/.claude/skills/ を読み込むため、このフラグでインストール先をそちらに向けます。

出典

このガイドは役に立ちましたか？

前へSkill のインストール次へOpenAI Codex

次に読む

すべてのガイド
Skill の使い方Skill に何を渡すか、作られたファイルをどう確認するか、より良い 2 稿目をどう引き出すか。Skill のトリガーの仕組みエージェントがある Skill をほかより優先して選ぶ理由と、選ばれる description の書き方。トラブルシューティング一覧にない、自動で動かない、途中で失敗する？見えている症状から解決方法を探せます。チートシートフォルダ、コマンド、SKILL.md のフィールドと制限を 1 ページにまとめました。