Claude Code の Skills 機能を使い始めたら、チームの得意技を再利用できるようになった話

👀 結論から

Claude Code には Skills という機能があって、よく使う手順やノウハウを再利用可能な形でパッケージ化できます！

.claude/skills/ 以下に Markdown ベースの定義を置いておくだけで、Claude Code が状況に応じて自動的に読み込んで使ってくれます。

実際にチームのプロジェクトに導入してみたら、属人化していた作業手順が一気に共有できるようになりました(^o^)/

Skills は「特定の作業のやり方」をひとまとめにして Claude Code に教えておける仕組みです。

hooks が「イベント発火でコマンドを実行する」機能なのに対して、Skills は「こういうときはこの手順で進めて」という判断材料を渡すイメージに近いです。

SKILL.md というファイルに、いつ使うべきか・どんな手順を踏むべきかを書いておきます。

Claude Code はユーザーの依頼内容を見て、関連しそうな Skill を自動で判断して読み込んでくれるので、毎回手動で呼び出す必要はありません！

自分のチームでは、まず「PRの説明文テンプレートを整える Skill」を作ってみました(^^)

.claude/skills/pr-description/SKILL.md

このファイルに、タイトルの付け方・本文の構成・レビュー観点のチェックリストを書いておくと、PRを作るたびに毎回同じフォーマットで整えてくれるようになりました！

次に作ったのは「デプロイ前の確認手順」をまとめた Skill です。

lint・型チェック・テストの実行順序と、失敗したときの切り分け方をSkill化しておいたら、新しく入ったメンバーでも同じ手順で進められるようになったのが結構大きいです。

一番変わったのは、口頭やSlackで伝えていた「暗黙のルール」が文章として資産になったことです。

以前は「あの作業どうやるんだっけ」と聞かれるたびに、自分が説明する時間が発生していました(´･ω･`)

Skillsに手順を書いておいてからは、Claude Code に頼むだけで同じクオリティの成果が返ってくるようになって、説明コストがかなり減りました！

チームメンバーが増えても、オンボーディングの負担がだいぶ軽くなった実感があります(^_^)

Skillの粒度をどこまで細かくするかは、正直まだ試行錯誤中です(・_・;)

粒度を細かくしすぎると管理するファイルが増えて逆に大変になるし、粗すぎると期待通りに読み込まれないこともあるかも・・・

また、Skillが自動で選ばれる仕組みなので、狙った通りに発火しているかは実際に試しながら確認する必要があります。

READMEに近い感覚で、定期的に見直して整理する運用が必要だと感じています。

パパ系Webエンジニア〜愛用ガジェット一覧 🛍️

AI開発・執筆に使っている作業デスク環境を楽天ROOMにまとめています ✨ デスク周りの参考にどうぞ 🙌

Claude Code の Skills 機能を使うと、チームのノウハウを再利用可能な形で資産化できます！

属人化しがちな手順をチームで使い回したい人は、ぜひ試してみてください🙌