Claude Code Skills 完全ガイド：自社固有の知識を再利用可能にする

Q: Skill は Git で共有できる？

できます。`.claude/skills/` をリポジトリにコミットすればチーム全員が同じ Skill を使えます。

Claude Code Skills は、自社固有の業務手順や API 仕様を Markdown ファイルで Claude に記憶させる仕組みです。.claude/skills/<name>.md に置くだけで、関連トピックが出てきた時に Claude が自動的に参照してくれます。

本記事では Skills の概念から、作り方・配置ルール・呼出パターン・実装例3本までを実機検証付きで紹介します。読み終えた時点で、自社の月次決算チェックや経費精算ルールなどを Skill 化して使い始められる状態を目指せます。

週1ニュースレター（無料）に登録すると、Skills のテンプレート集と最新事例が毎週木曜に届きます。

1. Claude Code Skills とは何か

Skills は、Claude Code に自社固有の知識・手順を Markdown で覚えさせる仕組みです。プロンプトに毎回貼るのではなく、.claude/skills/<name>.md に置くだけで Claude が必要な時に自動的に参照します。

主な用途:

自社のコーディング規約
業務手順書（経費精算フロー、月次決算手順など）
API リファレンス（社内 API のエンドポイント仕様）
特定ライブラリの「ハマりどころ」集

2. Skills の構造

---
name: 月次決算チェック
description: 毎月の決算書類を Claude Code でドラフトする際の社内ルール集
trigger_keywords: ["月次決算", "PL", "BS"]
---

## ミッション
freee API から取得した月次データを正規化し、PL/BS の差分が前月比 10% 以上ある項目を強調表示する。

## 入力
- freee API から取得した月次仕訳 JSON
- 前月の確定 PL/BS

## 手順
1. 仕訳 JSON を勘定科目別に集計
2. 前月との差分を計算
3. 10% 以上変動がある科目をフラグ
4. PL/BS を Markdown 表で出力

## 注意点
- 為替差損益はノイズになりやすい → 別表で扱う
- 連結の場合は親会社単体と全体を分けて表示

3. Skills の配置

your-project/
├── .claude/
│   ├── skills/
│   │   ├── monthly-closing.md
│   │   ├── code-style.md
│   │   └── slack-bot-protocol.md
│   ├── agents/
│   └── settings.json

Claude Code は起動時にこのディレクトリを自動スキャンし、エージェントが必要に応じて読み込みます。

4. 実装例 — 経費精算の自動化 Skill

---
name: 経費精算入力
description: Slack 投稿された領収書写真を Claude Code が判別し freee に登録する手順
---

## ミッション
Slack #経費 チャネルに投稿された領収書写真を Claude Code が:
1. OCR で金額・日付・店名を抽出
2. 勘定科目を推定（freee 補助科目マスタに照合）
3. freee API で「未確定明細」として登録
4. Slack に承認依頼を投稿

## 注意
- 飲食店は「会議費」が原則、5,000円超で「交際費」へ
- 交通費は「旅費交通費」、Suica チャージは資産計上しない
- レシートが英語なら OpenAI Whisper 経由で和訳してから登録

5. Skills とエージェントの違い

項目	Skills	エージェント
配置	`.claude/skills/`	`.claude/agents/`
役割	手順書 / How	役割定義 / What
呼出し	エージェントが必要時に参照	`claude -p --agent <name>`
サイズ	200-2,000字程度	100-500字 + 入出力定義
使い分け	「業務固有の知識」	「特定の役割を持つ人格」