Skills の自作

この章でわかること: 自分だけのスキルを作る基本。といっても、難しいプログラミングは 不要。手順を日本語で書いた1枚のファイルを置くだけです。

スキルの正体は「SKILL.md」1枚

スキルは SKILL.md というテキストファイルでできています。中身は2つのパートだけ。

---
name: brand-tone-check
description: 文言をブランドのトーンに沿って整える。文章を書く・直すときに使う。
---

# ブランドトーンの整え方

- 一人称は「私たち」に統一する
- 専門用語には必ず短い注釈を付ける
- 1文は40字程度を目安に短く区切る

• 上の --- で囲んだ部分(frontmatter)に name(名前) と description(どんな時に使うか) を書く
• その下に、やってほしい手順や約束事を普通の文章で書く

description が肝心

description は「いつ自動で使うか」をAIが判断する手がかりです。 「○○するときに使う」と具体的に書くほど、狙った場面で発動します。

作る手順

1. プロジェクト内に .claude/skills/<スキル名>/ フォルダを作る(例 .claude/skills/brand-tone-check/)
2. その中に SKILL.md を作り、上の形で書く
3. 保存すれば、そのセッション中の編集はそのまま反映される(フォルダを新しく 作った直後だけ、Claude Code を再起動すると確実)
4. /<スキル名>(例 /brand-tone-check)で呼び出して試す。フォルダ名がそのまま コマンド名になります(日本語ではなく英数字で付けましょう)

もちろんAIに作らせてもOK

「ブランドトーンを整えるスキルを作って。ルールはこれこれ」とClaude Codeに 頼めば、SKILL.md ごと用意してくれます。自作=自分で書く、である必要はありません。 対話で手伝ってほしいときは、superpowers の writing-skills スキルを使うと、質問に答えるだけで形にできます。

「/create-skill」という標準コマンドは無い

スキルはファイルを置くだけ(SKILL.md)で作れます。「スキル作成専用の スラッシュコマンドが標準である」わけではありません。手で作るか、上記のように AIに頼むのが基本です。

あなたの「考え方」こそ良いスキルになる

スキルの価値は、凝った仕組みよりあなたの判断基準を言語化できているかで決まります。 あなたが普段やっている——

• 要件定義の進め方(何を聞き、何を決めるか)
• デザインの判断軸(余白・配色・トーンのルール)
• レビューの観点(ここを必ず見る、という勘どころ)

——こうした「頭の中の手順」をSKILL.mdに書き写すと、それだけで再現性のある 強力なスキルになります。あなたの暗黙知を、AIが毎回使える形に変えるイメージです。

まず作ると良いスキルの例

• 公開前チェック: 顧客デモ前に確認する観点リスト
• 文言トーン: ブランドの言い回しに整える
• 画面追加の型: 新しいページを足すときの決まった手順

なぜ大事か

スキルを自作できると、あなたの判断基準やこだわりを、AIに恒久的に教え込めます。 一度作れば毎回効く——これが、VibeCoding を「自分仕様」に育てる最初の一歩です。

参考リンク(情報ソース)

• Claude Code 公式ドキュメント: https://code.claude.com
• Anthropic Agent Skills: https://docs.claude.com/en/docs/agents-and-tools/agent-skills