これはClaude Skillsに関する実践的で詳しいガイドです。Skillsとは何か、どのように追加するか、どれをインストールすべきか、そして自分自身のものをどう書くかを解説します。そして違いは見るのが一番わかりやすいため、このガイドは画像を中心に構成されています。Skillがない場合とSkillがある場合とで、あるタスクが実際にどう見えるかを示します。
平易な言葉で書かれており、実際に見られる具体例、Skillsが内部でどのように動作するかについてのより詳しい説明、そしてチーム全体に展開するための実践的な道筋を含んでいます。もし一つの節だけを読むなら、下にある3つのビフォー・アフターの例を読んでください。
一言で言うと
Claudeは優秀なジェネラリストです。Skillはそれを、1つの仕事を、あなたのやり方でこなすスペシャリストにします。そしてそれを覚えています。指示を一度書き、小さなフォルダとして渡せば、それ以降Claudeはその作業を毎回同じやり方でこなします。説明し直す必要も、メモアプリに取っておいたプロンプトをコピペする必要もありません。
違いは見るのが一番分かりやすいです。これは同じリクエストに対する答えで、まずSkillなし、次に適切なSkillをインストールした状態のものです。
例1 — ドキュメントを作る
あなたは取締役会向けレポートを頼みます。ドキュメントSkillなしでは、Claudeはプレーンテキストで精一杯のことをします。pdf skillをインストールしていれば、実際のファイルを生成します。表紙、ブランドバー、グラフ、きれいな表、フッター付きのページ。
# Q3 Results
売上は240万、Q2比で18%増。解約率は3.1%に低下。新規顧客: 412。文書にコピーできる要約はこちらです…
* 売上: 240万
* 解約率: 3.1%
* 新規: 412
プレーンテキストの壁。レイアウトもブランドもなく、そのまま送れる本物のファイルでもありません。
本物のPDF — 表紙、ブランドバー、グラフ、きれいな表、ページフッター。
リクエストは何も変わっていません。唯一の違いは、片方が本物のPDFの作り方を知っていることです。誰かが一度教えたからです。同じことが docx、xlsx、pptx にも言えます。変更履歴付きのWord文書、ピボットやグラフ付きのExcelモデル、ブランドに沿ったスライドデッキです。
例2 — SQLをレビューする
素のClaudeは、クエリが「問題なさそう」と喜んで言ってくれます。あなたのスキーマを知っているSkillは、はるかに有用なことをします。クエリをあなたのテーブルとインデックスに照らして確認し、本番で遅くなるものを指摘し、書き直します。
私には問題なさそうです! 👍 このクエリは有効なSQLで、お望みの行が返ってくるはずです。
愛想のいい肩すくめ。あなたのスキーマ、インデックス、何が遅くなるかについては何も。
⚠ フルテーブルスキャン が orders で発生 — customer_id にインデックスがありません。
修正 idx_orders_customer を追加し、こうします:
SELECT o.id, o.total
FROM orders o
WHERE o.customer_id = $1
AND o.created_at >= now() - interval '30 days';あなたのスキーマに照らして確認: フルテーブルスキャンを捕まえ、書き直します。
これは誰もあなたのために公開できない種類のSkillです。あなたのデータベースに依存するからです。それこそが、これがとても価値があり、そして — これから見るように — とても簡単に作れる理由です。
例3 — 安全なやり方でコードを書く
新機能を頼めば、Claudeはコードを書きます。test-driven-development skillをオンにして頼むと、手順の順序が変わります。まず失敗するテスト、次にそれを通すだけの最小限のコード、そして仕上げ。エッジケースは出荷後ではなく、出荷前に捕まります。
もちろん — こちらが applyDiscount() 関数とチェックアウトへの結線です。
// 80行のコード、テストはまだなし…
いきなりコードに飛びつきます。テストは後回し、あるいは皆無 — そしてエッジケースがすり抜けます。
まず失敗するテスト、それからちょうど足りるだけのコード、そして整頓。エッジケースは最初に捕まります。
これがSkillの要点を1枚の絵にしたものです。より賢いモデルではなく、規律あるモデル。慎重な同僚に守ってほしいと思う手順に従うのです。
最新のスキル — Claudeがあなたの休んでいる間に働くとき
上の3つの例は品質についてのものです。同じ作業を、きちんとやる。Claude Codeへの最新の追加は、別のもの — 時間についてです。Claudeがあなたの番と番の間も、スケジュールに沿って、あるいは一度に丸ごとエージェントのチームとして働き続けられるようにします。これらはインストールするファイルではなく、Claude Codeに組み込まれたスラッシュコマンドとして提供されますが、考え方は同じです。仕事を渡し、あなたのやり方で片付けてもらう。知っておく価値のある3つを、それぞれビフォー・アフターでご紹介します。
/loop — 長い作業のお守りをやめる
これは最も多く質問されるものです。デプロイ、CIの実行、遅いビルド — 普段なら座って何度も確認するもの。/loop があれば、Claudeがその再確認をあなたの代わりにやってくれます。そして巧妙なのは、自分でペースを調整するところです。
数分おきに自分で再確認し、着地の瞬間を捉えられることを願います。
Claudeがあなたの代わりにポーリングし、静かなときは長く待ち、着地した瞬間に通知して — それから自分で止まります。
モードは2つあります。間隔を与えると — /loop 5m check the deploy — 一定のペースで実行します。間隔を省くと — /loop check whether CI passed and fix any review comments — Claudeは各回のあとに自分で待ち時間を選びます。ビルドが活発なうちは短く、静かになれば長く。そして仕事が確実に終わったと証明できたら自分でループを終えることもできます。素の /loop は組み込みの「ブランチを手入れする」メンテナンス用プロンプトを実行します。自分で書いた .claude/loop.md があればそちらを。ループはセッション単位で、7日後に期限切れになるので、忘れられたループが永遠に走り続けることはありません。
/schedule — ノートパソコンなしで走る仕事
/loop はあなたのセッションが開いている必要があります。Routine(ルーティン)はそうではありません。仕事を一度定義し — プロンプト、触ってよいリポジトリ、必要なコネクター — それがAnthropicのクラウド上で、スケジュールに沿って、GitHubのイベント(PRがオープンされた、リリースが公開された)で、あるいは自分のWebフックで実行されます。あなたのマシンは電源を切っていても構いません。
月 — 走らせた ✓
火 — 忘れた 🙈
水 — ノートパソコンがスリープしていた
木 — 走らせた ✓
ノートパソコンがついていて、あなたが起動を思い出したときだけ走ります。1日忘れれば何も起きません。
クラウドのエージェントがスケジュール通り — あるいはGitHubのイベントで — 発火します。動かすマシンも、覚えておくことも不要です。
トレードオフはシンプルです。/loop はセッション中の手早いポーリング向けで、ローカルファイルを見られます。Routineは、あなたが机にいようがいまいが確実に起きなければならない仕事向けで、クラウド上のまっさらなクローンで実行されます。週次の依存関係チェック、朝のイシュー仕分け、マージ後のレビュー — 一度設定したら忘れてしまえます。
/code-review ultra — 疲れた1人の読み手ではなく、レビューチーム丸ごと
通常のレビューは1回の読み通しです。Ultraレビューはあなたのブランチをクラウド上のエージェントの艦隊に送り、それぞれが異なる角度から並行してレビューします。そして敵対的なパスを走らせ、すべての所見を反証しようと試みます。だから誤検知は落とされ、本物のバグだけがあなたのところに届きます。
LGTM 👍 命名にいくつか細かい点はありますが、それ以外はマージして良さそうです。
1回の読み通し。微妙なバグは、午後6時の疲れたレビュアーをすり抜けます。
エージェントの艦隊がクラウドで並行レビューし、その後の敵対的なパスが誤検知を捨てます — 本物の所見だけが残ります。
これは重量級の選択肢です。遅く、追加の利用分として課金されるので、危険なマージの前に手を伸ばすもので、ちょっとした変更のたびに使うものではありません。日常的な差分には、軽量な /code-review で十分です。Ultraは、賭け金が高いときに呼ぶセカンドオピニオンだと考えてください。
絵がなくても触れておく価値のある、新しめの構成要素があと2つあります。Sub-agents(サブエージェント)は、Claudeが大きな仕事を並行して働く複数のエージェントに振り分けられるようにします。1つがデータベース層を読み、別の1つがAPIを読む。そして答えを集めます。そしてpersistent memory(永続メモリ)は、Claudeがセッションをまたいでメモを保てるようにするので、毎朝プロジェクトを説明し直さずに済みます。/loop やRoutineと合わせて、方向性は明確です。あなたがClaudeを待つ時間が減り、あなたが別のことを進めている間にClaudeが働く時間が増えるのです。
Skillとは実際のところ何か
内側を見れば、Skillは清々しいほど地味です。必須のファイルが1つ入ったフォルダ、SKILL.md です。そのファイルには名前、説明、そして指示があります。任意でスクリプトや参照ファイルを隣に同梱できます。
---
name: sql-reviewer
description: Review and optimise SQL against our schema and conventions.
Use when the user writes, reviews, or tunes SQL queries.
---
# SQL reviewer
When given a query, check it against db/schema.sql, flag full table
scans, suggest indexes, and rewrite to our house style...
巧妙なのはClaudeがそれをどう使うかです。Claudeはインストール済みのすべてのSkillの名前と説明を常に見ています。それは安上がりで、それぞれ一文ずつにすぎません。しかし指示の全文は、あなたのリクエストが説明に一致したときだけ読み込みます。だから何十個のSkillをインストールしても、ある作業に実際に必要な1つか2つだけに(コンテキスト面、注意力面で)「コスト」がかかるのです。これが説明文がそれほど重要な理由です。それがトリガーなのです。曖昧な説明はSkillが決して発火しないことを意味し、鋭い説明(「Use when the user writes, reviews, or tunes SQL」)はまさに正しい瞬間に発火することを意味します。
Skillを追加する — うまくいくすべての方法
ウェブ版(claude.ai)
Settings → Capabilities を開き、「Code execution and file creation」をオンにします。次に Customize → Skills を開きます。そこから組み込みのSkill(ドキュメント系はここにあります)を切り替えるか、「+」 → 「Create skill」 → 「Upload a skill」をクリックして自作のものをZIPで投入できます。これはFree、Pro、Max、Team、Enterpriseの各プランで利用できます。
Claude Code(ターミナル)
道は2つあります。1つ目はただのファイルです。フォルダを所定の場所に置きます。
# personal, available everywhere
~/.claude/skills/<name>/SKILL.md
# project-local, shared with your team through Git
.claude/skills/<name>/SKILL.md
2つ目はマーケットプレイスで、良いコミュニティSkillはそこにあります。マーケットプレイスを一度追加すれば、あとはアプリのようにSkillをインストールできます。
# add a marketplace, then install from it
/plugin marketplace add anthropics/skills
/plugin install document-skills@anthropic-agent-skills
# or clone any skill repo straight into your skills folder
git clone https://github.com/owner/skill-name ~/.claude/skills/skill-name
プロジェクトローカルのSkill(.claude/skills/ の道)はチームにとっての隠れた立役者です。リポジトリにコミットすれば、すべてのチームメイト — そしてすべてのCI実行 — がセットアップなしで自動的に同じSkillを手にします。
本当にインストールする価値のあるSkill
役割ごとに分類しました。出典とインストール用の行は次の節に続きます。
ドキュメントとデータ
- pdf, docx, xlsx, pptx (anthropics/skills) — 例1のドキュメント作業の主力です。ブランドに沿ったデッキを作り、ピボットやグラフ付きのExcelモデルを生成し、変更履歴付きのWord文書を編集し、PDFからテキストや表を取り出します。インストール:
/plugin install document-skills@anthropic-agent-skills。 - csv-processing — CSVファイルを解析、クリーニング、検証、分析します。日々のデータ整形のためのSkillです。
- SQL — 自作しよう(例2)。あなたのスキーマ、命名、クエリの慣習を知っているSkillは、どんな汎用品にも勝ります。やり方は下に示します。
コード品質とQA
- test-driven-development (obra/superpowers) — 例3の RED → GREEN → REFACTOR の規律です。非フレーキーな非同期テストのための testing-anti-patterns と condition-based-waiting と組み合わさります。
- systematic-debugging (superpowers) — 当て推量ではなく、4段階の根本原因究明メソッドです。修正が実際に効いていることを証明する verification-before-completion も付属します。
- webapp-testing (anthropics/skills) — Playwrightで本物のブラウザを動かし、UIが機能することを検証します。
- requesting-code-review / receiving-code-review (superpowers) — 重大度タグ付きの所見を含むレビュー前チェックリストと、フィードバックを落ち着いて取り込む方法です。
作る前に考える(「グリル」)
- brainstorming (superpowers) — コードを1行も書く前に、難しい問いであなたの計画を問い詰めるソクラテス式のグリルです。悪いアイデアを葬る最も安い方法です。
- writing-plans (superpowers) — 作業を、正確なファイルパス付きの小さく検証可能なタスクに分解するので、実行が最良の意味で退屈になります。
- request-refactor-plan — 恐ろしいリファクタリングを、1回の大きく危険な跳躍ではなく、小さく安全なコミットの連なりに変えます。
執筆とコミュニケーション
- writing-fragments → writing-shape → writing-beats — 散らかったメモの山から、形の整った下書き、そして完成した記事へと、一度に1つの判断を重ねて導いてくれる一族です。記事や提案書に本当に役立ちます。
- brand-guidelines (anthropics/skills) — あらゆる文書とメッセージをブランドに沿わせます。あなたの声、あなたのルールで。
- internal-comms — 社内メモ、お知らせ、更新情報を一貫したトーンで起草します。
Git、出荷、ツールの接続
- using-git-worktrees と finishing-a-development-branch (superpowers) — 自分の居場所を見失わずに複数のブランチを並行して作業し、その後きれいにマージ/PRの判断を下します。
- commit & PR helpers (official marketplace) — チーム全体で一貫したコミットメッセージとプルリクエストを実現します。
- mcp-builder (anthropics/skills) — Claudeがあなた自身のシステムやデータに届くようにコネクターを作ります。これが、すでに運用しているツールにClaudeを組み込む方法です。
どこで見つけるか
- github.com/anthropics/skills — Anthropicの公式コレクション(ドキュメントSkill、webapp-testing、mcp-builder、brand-guidelines、canvas-designほか)に加え、自作用のテンプレートも。
/plugin marketplace add anthropics/skillsで追加します。 - obra/superpowers — 最も愛されているコミュニティライブラリです。TDD、デバッグ、ブレインストーミング、計画立案、コードレビュー、gitワークフロー。
/plugin install superpowers@claude-plugins-official(または/plugin marketplace add obra/superpowers-marketplace)でインストールします。 - claude.com/plugins — 公式マーケットプレイス。Claude Code内から
/pluginで閲覧できます。GitHub、Stripe、Figmaといったチームのコネクターやツールキットがあります。 - 「awesome-claude-skills」リスト — 何百ものSkillをカテゴリ別にまとめたコミュニティのディレクトリです。
karanb192/awesome-claude-skillsとComposioHQ/awesome-claude-skillsが良い出発点です。
自作のものを10分で書く
最も価値あるSkillは、あなたにしか書けないものです。例2のSQLレビュアーの、レシピのすべてがこれです。
- フォルダを作る:
~/.claude/skills/sql-reviewer/。 - その中に
schema.sqlを置き、Claudeが本物のテーブルを見られるようにする。 - 鋭い説明とあなたのハウスルールを書いた
SKILL.mdを加える(先ほどのスニペットがそのまま完全な出発点です)。 - Claudeにクエリのレビューを頼む。説明が一致し、Skillが読み込まれ、例2の出力が得られます。
これがループのすべてです。難しいのは形式ではありません。「あなたのやり方」が実際に何を意味するかを決め、それを一度書き留め、二度と説明しないことです。
何かをインストールする前の、たった1つのルール
Skillはあなたのマシン上でコードを実行できます。だから、Skillのインストールはソフトウェアのインストールとまったく同じように扱ってください。自分で書いたSkillか、信頼できる出典のものを選び、まず SKILL.md を読むこと。2分の読み込みは、頼んでもいないことを密かに行うSkillに対する、安上がりな保険です。チームにとっては、プロジェクトローカルの .claude/skills/ フォルダに通常のコードレビューを加えるのが最も安全なモデルです。Skillは、あなたが出荷する他のどんなコードとも同じ精査を受けます。
まとめ
上の3枚の絵をもう一度見てください。どの場合もモデルは同じで、リクエストも同じ。変わったのは規律だけです。それがSkillの正体です。あなたの基準をClaudeに一度渡し、毎回それを適用させる方法。上記のリストからいくつかインストールして違いを体感し、それから他の誰もあなたのために公開できない、あの1つを書いてください。あなたのスキーマ、あなたのブランド、あなたの出荷の流儀を知っているSkillです。そのとき、Claudeは賢いジェネラリストであることをやめ、本当にあなたのものになるのです。