スピンアウト講座03_CLAUDE-MDとSKILL-MD

CLAUDE.md = 全業務に適用されるルール、SKILL.md = 特定業務の自動化手順。読み込みタイミングやスコープの違いを理解し、「どちらに書くべきか」の判断フローチャートで迷わなくなります。

OffersにはAI Talent（トップクラスAI人材）が多数登録しています。その方たちとチームを組み、AIコンサルティングサービスを開始しています。ご関心のある方はこちらからご登録ください。順次、弊社よりご連絡させていただきます。
https://share-na2.hsforms.com/13F_F95BrTLaqRMk1hYhxQg3rs27

Transcript

1. CLAUDE.MD と SKILL.MD スピンアウト講座 03 Claude Codeの核心を理解する ver. 2026.03
2. CONFIDENTIAL CLAUDE.md を理解する AIの人格と行動ルールを定義するファイル
3. CLAUDE.md を理解する CONFIDENTIAL © Offers All rights reserved. 1 なぜこの2つのファイルが「核心」なのか Claude Code は賢いが... あなたの会社のルールは知りません メールの敬語レベルは？ レポートの書き方は？ どのフォルダに何を保存する？ 議事録の形式は？ 2つのファイルで解決 CLAUDE.md = 社員ハンドブック 全業務に適用される基本ルール SKILL.md = 業務マニュアル 特定の業務の手順書
4. CLAUDE.md を理解する CONFIDENTIAL © Offers All rights reserved. 2 CLAUDE.md の役割 Claude Code が「常に従うルール」を書くファイル。起動するたびに最初に読み込まれます。 ユーザーグローバル ~/.claude/CLAUDE.md 全プロジェクト共通 個人の基本ルール プロジェクトルート ./CLAUDE.md チーム共通ルール Git で共有可能 サブディレクトリ ./src/CLAUDE.md 領域固有のルール 深いフォルダが優先 ルールファイル .claude/rules/*.md 分割管理 自動読み込み 深いフォルダの CLAUDE.md が優先されます（同じルールが競合した場合）
5. CLAUDE.md を理解する CONFIDENTIAL © Offers All rights reserved. 3 配置場所と読み込み優先度 配置場所 読み込みタイミング 用途 優先度 ~/.claude/CLAUDE.md 常に読む 個人の基本ルール（トーン、出力形式等） 低 ./CLAUDE.md プロジェクト内で読む チーム共通ルール（Git で共有可能） 中 サブディレクトリの CLAUDE.md そのフォルダで作業時 領域固有のルール 高 .claude/rules/*.md 常に読む CLAUDE.md の分割管理 同等 グローバル → プロジェクト → サブディレクトリ の順で、深い階層のルールが優先 グローバル ▶ プロジェクト ▶ サブディレクトリ
6. CLAUDE.md を理解する CONFIDENTIAL © Offers All rights reserved. 4 CLAUDE.md に書くべき内容 01 基本姿勢 トーン設定 結論ファースト 専門用語の扱い 02 出力ルール ファイル形式 日付フォーマット 表・箇条書き活用 03 フォルダ構造 プロジェクトの ディレクトリ構造 保存先ルール 04 禁止事項 やらないこと ファイル削除禁止 パッケージ制限 例: 「きれいに書いて」ではなく「表と箇条書きを使い、結論を冒頭に置く」
7. CLAUDE.md を理解する CONFIDENTIAL © Offers All rights reserved. 5 CLAUDE.md のベストプラクティス 1 200行以内に抑える 長すぎるとAIのパフォーマンスが低下。詳細は rules/ やスキルに分離 2 具体的に書く 「きれいに書いて」→「表と箇条書きを使い、結論を冒頭に置く」 3 禁止事項を明記する 「やること」だけでなく「やらないこと」も書く 4 定期的に見直す 不要なルールを削除し、新しいルールを追加する 5 チームで共有する プロジェクトルートの CLAUDE.md は Git で管理する 200行を超えそう？ → .claude/rules/ に分割！ rules/ 配下の .md ファイルは自動で読み込まれます email-rules.md report-format.md naming-rules.md
8. CONFIDENTIAL SKILL.md を理解する AIのスキル（技能）を定義するファイル
9. SKILL.md を理解する CONFIDENTIAL © Offers All rights reserved. 6 CLAUDE.md vs SKILL.md 比較項目 CLAUDE.md SKILL.md 読み込みタイミング 常に読む スキルが呼び出された時だけ スコープ すべての対話に適用 特定のタスクにのみ適用 内容 基本ルール、制約、構造情報 業務手順、入出力、判断基準 人間に例えると 社員ハンドブック 業務マニュアル サイズ感 200行以内 制限なし（詳細に書いてOK） CLAUDE.md = 「全社ルール」常にON SKILL.md = 「業務別」呼び出し時だけ
10. SKILL.md を理解する CONFIDENTIAL © Offers All rights reserved. 7 SKILL.md のディレクトリ構造 必須 SKILL.md スキル定義ファイル YAMLフロントマター + 実行手順 + ルール 推奨 examples/ 入出力のサンプル 理想的な出力を見せて 品質を飛躍的に向上 任意 references/ 参考情報・知識 敬語基準、顧客一覧等 スキル実行時に自動参照 .claude/skills/{skill-name}/ 配下に上記3フォルダを配置
11. SKILL.md を理解する CONFIDENTIAL © Offers All rights reserved. 8 SKILL.md の基本構造 YAML フロントマター description と trigger を定義 ▼ 概要 スキルの目的を1-2文で説明 ▼ 実行ステップ 1. データ取得 → 2. 生成 → 3. 保 存 ▼ 入力 / 出力 何を受け取り、何を返すか定義 ▼ ルール 守るべき制約・フォーマット SKILL.md --- description: 日報を自動生成する trigger: 「日報を作成して」 --- # 日報スキル ## 実行ステップ 1. Calendar から予定を取得 2. tldv から会議要約を取得 3. 日報テンプレートで生成 4. Obsidian に保存 5. Slack に通知
12. CONFIDENTIAL 実践 TIPS SKILL.md を効果的に使いこなす5つのコツ
13. 実践 TIPS CONFIDENTIAL © Offers All rights reserved. 9 TIPS 1: いきなり作らない 非効率な方法 ✖ 1. SKILL.md の仕様を調べる 2. 完璧な手順書を書こうとする 3. 試行錯誤してデバッグ 時間がかかる上に、実務とずれる 効率的な方法 ✔ 1. Claude Code に自然言語で依頼 2. うまくいった手順を確認 3. 「今の作業をSKILLにして」 Claude Code が自動でSKILL.md を生成！ あなた: 「日報を作成して」→ Claude: （実行）→ あなた: 「この作業をSKILLにして」→ Claude: （SKILL.md 自動生成）
14. 実践 TIPS CONFIDENTIAL © Offers All rights reserved. 10 TIPS 2: examples/ が品質を決める サンプルの入力と出力を 置くだけで、スキルの精度が 飛躍的に向上します 言葉で説明するよりも、 「こういう出力が欲しい」という サンプルを見せる方が はるかに効果的です。 examples/ フォルダ構造 .claude/skills/daily-report/ ├── SKILL.md ├── examples/ └── sample-report.md ↑ 品質が 飛躍的に向上
15. 実践 TIPS CONFIDENTIAL © Offers All rights reserved. 11 TIPS 3〜5: さらなる活用テクニック 03 references/ で 知識を渡す references/ に置いたファイルは スキル実行時にClaude Codeが自 動で参照。敬語基準やクライアン ト一覧を格納。 04 段階的に 改善する V1: 最低限の手順 → V2: 判断基準・エッジケース追 加 → V3: examples/ にベストプラク ティス追加 05 skill-authoring スキルを使う 「SKILLを作成してください」と 依頼するだけで、ベストプラク ティスに沿ったSKILL.mdを対話 的に自動生成。
16. CONFIDENTIAL 使い分けと応用 CLAUDE.md と SKILL.md の最適な使い分け
17. 使い分けと応用 CONFIDENTIAL © Offers All rights reserved. 12 使い分けの判断フロー そのルールは全業務に適用される？ YES ▼ NO ▼ CLAUDE.md に書く 例: 「出力は日本語」 「結論ファースト」 「日付はYYYY-MM-DD」 特定の業務にのみ適用される？ YES ▼ 判断が難しい ▼ SKILL.md に書く 例: 「日報は19時に生成」 「メールは敬語変更」 まず CLAUDE.md 長くなったら SKILLに分離 ルール CLAUDE.md SKILL.md 「日本語で回答する」 ✔ 「ファイルを削除しない」 ✔ 「メール作成時の敬語基準」 ✔
18. 使い分けと応用 CONFIDENTIAL © Offers All rights reserved. 13 高度な活用テクニック CLAUDE.md の 分割管理 .claude/rules/ 配下に 分類ごとのmdファイルを配置 slack-rules.md email-rules.md report-format.md security.md スキル間の 連携 あるスキルの出力を 別スキルの入力に利用 例: meeting-task-extract の出力を daily-report に反映 CLAUDE.md の 自動改善 セッション中の学びを 自動でCLAUDE.mdに反映 「CLAUDE.md を読んで 改善点を提案してください」 と依頼するだけ
19. 使い分けと応用 CONFIDENTIAL © Offers All rights reserved. 14 実践課題 まずは小さく始めて、徐々に育てていくのがコツです Step 1 最低限の CLAUDE.md（30行程度）を作成する 今日 Step 2 2週間使い、足りないルールを追加する 2週間 Step 3 「毎回同じ指示を出している」タスクを1つ見つける 2週間〜 Step 4 Claude Code で実行 → 成功したら SKILL.md 化する 3週間〜 Step 5 examples/ にサンプルを追加して品質を検証する 1ヶ月〜 Step 6 CLAUDE.md が200行超えたら rules/ に分割する 随時 まずは CLAUDE.md を30行書くところから始めましょう！
20. 　　　　── AI時代のエンジニア転職プラットフォーム AIにできないことが1つだけあります。それは「何がしたいか」という夢を持つこと。 人間ならではの好奇心や違和感こそが、未来で最も価値ある「問い」になる。 Offersは、個人の「問い」と企業の「問い」が響き合い、新しい価値を生み出す場所です。 求職者の方へ Offersは「今すぐ転職する人」だけのサービスではありません。AI 時代のキャリア相談、先端AI企業への転職、職務経歴の棚卸しやAI による強み分析も可能です。 offers.jp ─ まずは無料登録 Offers職務経歴 AIx人間ハイブリッドの職務経歴作成サービス 企業の方へ OffersはAI RPOサービスです。35,000人以上の登録ユーザーからAI が最適な候補者を発見し、心理フェーズに合わせたスカウトを自動 配信。採用戦略の設計は専任CSチームが伴走し、「再現性ある採 用」を実現します。 サービスを見てみる PR
21. FIN