Skills

手順

1. 置き場所の型を覚える

Skillの実体は、フォルダ1つとその中の SKILL.md というファイルです。

~/.claude/skills/
└── gijiroku/          ← スキル名のフォルダ（1フォルダ＝1スキル）
    └── SKILL.md       ← 手順書の本体（この名前で固定）

フォルダ名がそのまま呼び出し名になります。gijiroku フォルダなら /gijiroku で呼べます。日本語名も動きますが、入力しやすい半角英数字がおすすめです。

2. フォルダを作る

今回は「議事録まとめ」スキルを作ります。全プロジェクトで使いたいので ~/.claude/skills/ に置きます。

mkdir -p ~/.claude/skills/gijiroku

-p は、途中のフォルダ（この場合 skills）が無ければ、まとめて作るという指定です。

3. SKILL.md を書く

ファイルを作って開きます。

touch ~/.claude/skills/gijiroku/SKILL.md
open -e ~/.claude/skills/gijiroku/SKILL.md

次を丸ごと貼って、Cmd+S で保存してください。

---
name: gijiroku
description: 会議メモや文字起こしから議事録を作る。「議事録にして」「議事録まとめて」「会議メモを整理して」と頼まれたときに使う。
---

渡された会議メモや文字起こしを、次の形式の議事録にまとめてください。

## 出力形式
- 会議名・日付（分かる範囲で）
- 決まったこと（箇条書き）
- やること（誰が・何を・いつまでに）
- 持ち越し（決まらなかったこと）

## ルール
- 発言の引用は最小限にして、結論だけを書く
- 決まっていないことを、決まったことのように書かない
- 全体で20行以内に収める

上下2つの --- で挟まれた部分が frontmatter（設定欄）です。

• name … 一覧に表示される名前。省略するとフォルダ名が使われます
• description … 何をするスキルで、いつ使うか

一番大事なのは description です。Claudeはここを読んで、「今このスキルの出番だ」と自分で判断します。だから、自分が実際に言うセリフ（「議事録にして」）をそのまま入れておくのがコツです。

4. 呼び出して動かす

Claude Codeを新しく起動します。

claude

呼び出し方は2つあります。まずは、お願いの言葉から自動で発火するかを試します。

「決まったこと・やること・持ち越し」の形式で返ってくれば、スキルが動いています。descriptionに書いたセリフと依頼が合ったので、Claudeが自分で手順書を開いたのです。

もう1つは、名前で直接呼ぶ方法です。

/gijiroku

/ を打つと候補一覧に gijiroku が出ます。確実に使わせたいときは、こちらで呼びます。

毎回形式を説明しなくても、同じ型で出てくる。これがSkillの効果です。

5. 発火しないときの直し方

うまく動かないときは、原因はほぼこの3つです。

Claudeに直接聞くのも有効です。

一覧に出ていれば、Claudeからは見えています。あとは description の調整の問題です。