Claude Codeは、ディスクから実際にSkillsをインストールできる唯一のClaudeの環境です。そのため、Custom Instructionsについて書かれた他のすべての説明とは異なるアドバイスが必要です。これは実践的なガイドです。フォルダーの仕組み、残す価値のあるSkillの条件、そして人々が時間を無駄にしている場所について説明します。
Claude CodeでSkillsが機能する仕組み
Skillsは.claude/skills/ディレクトリに保存されます。各Skillは、その中にSKILL.mdを含むサブフォルダーです。重要なのは2つの場所です。
-
プロジェクト - リポジトリ内の
.claude/skills/。Skillがコードと一緒に移動するため、チーム全員が利用できます。プロジェクト固有の内容はここに置きます。 - 個人 - ホームディレクトリ内の同じパス。自分が作業するすべてのものに適用されます。自分自身の習慣はこちらに置きます。
一度に1つだけ保持するCustom Instructionsとは異なり、Claude Codeでは複数のSkillsを保持し、作業内容に合うものを呼び出せます。そのため、優れたSkillの条件も変わります。適切なものが選ばれるほど正確で、何にでも選ばれてしまわないほど範囲が限定されている必要があります。
Skillが実際に残す価値を持つ条件
これらを数多く作ってきた結果、パターンは一貫しています。優れたSkillsは情報ではなく判断を記録します。
REST APIとは何かを説明するSkillは、モデルがすでに知っていることにトークンを浪費します。一方、「このリポジトリでは、すべてのエンドポイントがRFC 7807形式でエラーを返し、そうなっていない3か所はレガシーなのでコピーしてはいけない」と記したSkillは、永遠に残す価値があります。これはモデルが推測できない判断だからです。
判断基準はこうです。あなたのチームに加わる有能なエンジニアに伝える必要があることなら、Skillに入れます。すでに知っているはずのことなら、入れません。
用意する価値のあるカテゴリー
チーム内標準に基づくコードレビュー
一般的なレビューコメントはノイズです。チームの実際の慣習、つまり議論して結論を出した内容を含むレビューSkillがあれば、レビューを意見ではなくチェックリストに変えられます。
テストの慣習
どのフレームワークを使うか、テストの名前をどう付けるか、何をモックし、何は決してモックしないか、このコードベースで十分なカバレッジとは何か。これがなければ、トレーニングデータで最も一般的だったスタイルでテストが書かれます。
デバッグとインシデント対応
ログの場所、どのダッシュボードがどの疑問に答えるか、エスカレーション前に確認する4つの項目。これは午前3時に元を取れるSkillです。
インフラとデプロイ
デプロイの手順、本番環境に対して安全に実行できることとできないこと、メンテナンス時間が必要なマイグレーション。危険な部分を記録することが目的です。
ドキュメントとテクニカルライティング
ドキュメントの場所、ページの構成、チーム内のスタイルでチュートリアルとリファレンスをどう区別するか。
省くべきもの
言語チュートリアル。 ClaudeにPythonの構文を説明するSkillは、すでにPythonの構文を知っているものにPythonの構文を説明するSkillです。
巨大な何でも入りのSkills。 フロントエンド、バックエンド、テスト、デプロイを1つのSkillで扱うと、常に読み込まれるうえ、そのたびに大部分が無関係になります。分割しましょう。
1か月後には古くなるもの。 バージョン番号、現在のスプリント目標、オンコール担当者の名前。Skillsは長く有効な判断のためのものです。
曖昧な説明。 説明にSkillを適用するタイミングが明確に書かれていなければ、まったく選ばれないか、常に選ばれます。どちらも役に立ちません。
白紙ではなくテンプレートから始める
最も難しいのはアイデアではなく、形を決めることです。どこまで具体的にするか、何を省くか、選択が機能するように説明を書く方法。すでに検証されたものからコピーする価値があるのは、その部分です。
私たちは、開発者、DevOps、アーキテクト向けの役割別Skillファイルを公開しています。プレーンな.mdで記述されており、Claude CodeのSkillとして使うことも、Custom Instructionsに貼り付けることもできます。
Claude Code Skills →
開発者向けSkills →
DevOps向けSkills →
アーキテクト向けSkills →
Claude Codeを使っておらず、それでもここにたどり着いた場合、ウェブ版のClaudeに相当するものはCustom Instructionsです。
KissMySkillsは独立したマーケットプレイスであり、Anthropic、OpenAI、その他のAI企業とは提携、承認、関係のいずれもありません。Claude CodeはAnthropicの製品です。
