MENU

【AI】Claude Codeでスキル(Skill)を自作する方法

AI
いずみ
当ページのリンクには広告が含まれています。
この記事で解決できる悩み
いずみ

こんな悩みを解決できる記事を書きました！

僕は現役フリーランスエンジニア(歴年)で、資格は個保有しています。

「Claude Codeでスキル(Skill)を自作する方法を知りたい」とお考えではありませんか？

Claude Codeに同じ手順やチェックリストを毎回チャットで貼り付けている方へ。

SKILL.mdというファイルを1つ作るだけで、その手順をClaude Codeの常備機能として持たせることが可能です。

いずみ

CLAUDE.mdに書き足すよりも、Skill機能を使った方法の方がスッキリまとまります。

ということで、本記事ではClaude Codeでスキル(Skill)を自作する方法を解説します。

いずみ

すぐ読み終わるので、ぜひ最後まで読んでくださいませ。

スクロールできます
【当サイト】おすすめフリーランスエージェント3選
エージェント評価ポイント公式サイト
レバテックフリーランス

5.0		業界最大級のエージェント。
高単価案件が豊富。		公式
Midworks

4.8		満足度調査で
3年連続3冠を達成。		公式
ITプロパートナーズ

4.6		週2〜3向けの案件が豊富。公式
執筆者／監修者
  • フリーランスエンジニア（保有資格個、企業と直接契約）
  • ブログ・アフィリエイト歴7年（2018年〜）
  • ブランドせどりで月利50万円⇨脱サラ
  • 投資（仮想通貨・FX）歴7年（2018年〜）
  • X（旧Twitter）フォロワー約1,900人
  • 運営者情報はこちら
いずみです
よく読まれている記事はこちら！
目次

【AI】Claude Codeでスキル(Skill)を自作する方法

早速ですが、Claude Codeでスキル(Skill)を自作する方法を解説します。

Claude CodeのSkillとは

Skillとは、SKILL.mdというMarkdownファイル1つでClaude Codeの振る舞いを拡張する仕組みです。

SKILL.mdには、YAMLのフロントマターと実行手順を書いたMarkdown本文の2つを記述します。

作成したスキルは、ディレクトリ名から自動でスラッシュコマンドになります。

例えば.claude/skills/commit-helper/SKILL.mdというファイルを作ると、/commit-helperというコマンドで呼び出せるようになります。

フロントマターのdescriptionに合致する会話の流れがあれば、Claude Codeが自動でスキルを読み込んで使うことも可能です。

いずみ

毎回同じ指示を貼り付けていた作業ほど、Skill化の効果を実感しやすいです。

Skillの保存場所を決める

SKILL.mdは保存する場所によって、利用できる範囲が変わります。

  • ~/.claude/skills/<スキル名>/SKILL.md(個人用。すべてのプロジェクトで利用可能)
  • .claude/skills/<スキル名>/SKILL.md(プロジェクト用。該当プロジェクトのみで利用可能、Gitでの管理も可能)

チームで共有したいスキルはプロジェクト用のパスに置き、個人の作業効率化のためのスキルは個人用のパスに置くという使い分けがおすすめです。

実装(コード付き)

本項では、未コミットの変更差分を要約してコミットメッセージ案を作るスキルを実際に作成してみます。

STEP
スキル用のディレクトリを作成する

プロジェクト直下に、スキル名のディレクトリを作成します。

mkdir -p .claude/skills/commit-helper
STEP
SKILL.mdを作成する

フロントマターにname・descriptionを書き、本文に実行手順を書きます。

!`コマンド`という書き方をすると、Claude Codeがスキル読み込み前にコマンドを実行し、その出力結果を本文に埋め込んでくれます。

---
name: commit-helper
description: 未コミットの変更を要約してコミットメッセージ案を作る。差分の内容や変更理由を聞かれたときにも使う。
---

## 変更差分
!`git diff --staged`

## 指示
上記の差分を確認し、変更内容を簡潔にまとめたコミットメッセージ案を1つ提案してください。
差分が空の場合は、ステージされた変更がない旨を伝えてください。
STEP
スキルの動作を確認する

ファイルを保存したら、Claude Codeを起動して/commit-helperと入力します。

「コミットメッセージを考えて」のようにdescriptionと合致する会話をした場合も、Claude Codeが自動でスキルを読み込みます。

いずみ

ステージ済みの差分がある状態で試すと、動作が分かりやすいです。

フロントマターで呼び出し方法を制御する

deployやcommitのように副作用のある処理は、Claude Codeが勝手に自動実行しないよう制御したくなります。

disable-model-invocation: trueを設定すると、ユーザーがスラッシュコマンドで呼び出したときだけスキルが動作し、Claude Codeが自動で呼び出すことはなくなります。

allowed-toolsを設定すると、スキルを呼び出したターンに限り、指定したツールを承認プロンプトなしで実行できます。

---
name: commit-helper
description: 未コミットの変更を要約してコミットメッセージ案を作る。
disable-model-invocation: true
allowed-tools: Bash(git add *) Bash(git commit *) Bash(git status *)
---
いずみ

allowed-toolsの権限は次のメッセージを送った時点でリセットされるので、セッション全体で許可したいツールは通常のパーミッション設定の方に書いた方がよいです。

SKILL.mdを肥大化させないコツ

SKILL.mdの内容は、スキルが読み込まれるたびに会話履歴へ残り続けます。

詳細なAPI仕様やサンプル集などの参考資料は、SKILL.mdから分離した別ファイルに書くのがおすすめです。

commit-helper/
├── SKILL.md
├── reference.md
└── scripts/
    └── helper.py

reference.mdやscriptsフォルダの中身は、SKILL.mdから必要になったときだけClaude Codeが参照します。

スクロールできます
【当サイト】おすすめフリーランスエージェント3選
エージェント評価ポイント公式サイト
レバテックフリーランス

5.0		業界最大級のエージェント。
高単価案件が豊富。		公式
Midworks

4.8		満足度調査で
3年連続3冠を達成。		公式
ITプロパートナーズ

4.6		週2〜3向けの案件が豊富。公式

【厳選】フリーランスエンジニアにおすすめなエージェント3選

フリーランスエンジニアになるにはエージェントから案件をもらう必要があります。

僕が実際に利用しているおすすめエージェントを紹介しますね。

いずみ

エージェントは必ず複数登録してください。

担当者によっては「全然案件紹介してくれない…」みたいなこともあるので…

僕は実際に5つのエージェントを使い回していますよ。

フリーランスを始めるなら「」

案件数マージン率単価
約88,000件非公開高
初心者福利厚生申し込み
無料
Good Point
  • 業界最大級の案件数。
  • 業界トップクラスの高単価報酬、低マージン（平均年収862万円）。
  • 案件参画中のフォローの充実。

※詳細は「【業界最大手】レバテックフリーランスとは？メリットや利用手順を解説！」を参照。

は業界最大手のフリーランスエージェントです。

とにかく案件数が多いので、とりあえず登録しておけば間違いないエージェントです！

いずみ

僕もはじめてフリーランスの案件を貰ったのはです。

保有している案件数が多いので、業務経験がなくても何かしらの案件は紹介してもらえますよ（僕はJavaの経験3年でも案件を貰えました）。

詳細はコチラ
公式サイトを詳しく見る

手厚い保障を重視したいなら「」

案件数マージン率単価
約10,000件非公開中
初心者福利厚生申し込み
無料
Good Point
  • 手厚い保障で正社員並みの安心感。
  • 還元率60％超え＆単価公開でクリアな契約。
  • 給与保障制度（審査あり）。

は手厚い保障が特徴のフリーランスエージェントです。

フリーランスを目指しているけど不安な方や保障を重視したい方におすすめです。

いずみ

僕も何度か案件を紹介してもらいました。

自分のスキルに合った案件を紹介してもらえましたし、電話のやり取りも非常に丁寧でした。

詳細はコチラ
公式サイトを詳しく見る

週2〜3日の案件探しなら「」

案件数マージン率単価
約5,000件非公開高
初心者福利厚生申し込み
経験者向け無料
Good Point
  • IT案件に特化したフリーランスエージェント。
  • 週2〜3日の案件が豊富。
  • リモート案件が多く、直エンドなので単価も高い。

※詳細は「【週2・3案件】ITプロパートナーズとは？メリットや利用手順を解説！」を参照。

はIT案件に特化したフリーランスエージェントです。

週2〜3日から参画できる案件が豊富なので、起業したい人にもおすすめです。

いずみ

週2〜3日の案件はある程度スキルがないと紹介してもらえない印象です。

とはいえ、週5の案件ももちろんありますし、僕が利用した時は迅速・丁寧に対応していただきました！

詳細はコチラ
公式サイトを詳しく見る

よくある質問

SkillとSubagent(サブエージェント)は何が違いますか？

Skillは、呼び出されると内容がそのままメインの会話履歴に読み込まれる指示書です。

一方Subagentは、独立したコンテキスト・ツール権限・モデル設定を持つ別プロセスとして動作します。

SKILL.mdのフロントマターにcontext: forkを設定すると、Skillの実行自体をSubagentに任せることも可能です。

既存の.claude/commands/に書いていたコマンドはどうなりますか？

.claude/commands/配下のファイルは、これまで通りスラッシュコマンドとして動作し続けます。

Skill形式に移行すると、補足ファイルの追加やフロントマターによる呼び出し制御など、追加の機能が使えるようになります。

SKILL.mdの内容はどのタイミングでClaude Codeに読み込まれますか？

descriptionの部分は、セッション開始時から常にClaude Codeのコンテキストに含まれています。

本文の全内容は、スキルが手動または自動で呼び出されたタイミングで初めて読み込まれます。

まとめ

今回は、Claude Codeでスキル(Skill)を自作する方法について解説しました。

以下が本記事のまとめになります。

まとめ
  • SKILL.mdは、YAMLフロントマターとMarkdown本文の2部構成で書く。
  • 個人用(~/.claude/skills)とプロジェクト用(.claude/skills)を用途に応じて使い分ける。
  • disable-model-invocationやallowed-toolsで、呼び出し方法とツール権限を制御できる。
  • SKILL.mdは簡潔に保ち、詳細な資料は補足ファイルに分離する。
まとめ
いずみ

最後までお読みいただき、ありがとうございました！

スクロールできます
【当サイト】おすすめフリーランスエージェント3選
エージェント評価ポイント公式サイト
レバテックフリーランス

5.0		業界最大級のエージェント。
高単価案件が豊富。		公式
Midworks

4.8		満足度調査で
3年連続3冠を達成。		公式
ITプロパートナーズ

4.6		週2〜3向けの案件が豊富。公式
  • クソおすすめ本
世界一流エンジニアの思考法 牛尾剛
¥4,480 （2024/06/01 23:28時点 | Amazon調べ）
Amazon
楽天市場
いずみ

海外のエンジニアがどういった思考で働いているかが理解できます。

海外に行く気はないけど海外エンジニアの動向が気になる雑魚エンジニアにおすすめです（本当におすすめな本しか紹介しないのでご安心を）。

AI

この記事が気に入ったら
フォローしてね！

シェアしてね！
  • URLをコピーしました！
目次