会社でClaude Desktopを使っていて、いちばん効果があった取り組みが「社内文書のフォーマットをSkillにしてチームで共有する」でした。
それまでは、週次報告書や障害報告書を各自がClaudeに書かせるたびに、見出しの順番がバラバラ・必須項目が抜ける・体裁が揃わない、といった書式の手戻りが地味に発生していました。フォーマットをSkillに切り出して共有したら、これがほぼ消えました。この記事では、何をどう作って、どうチームに配ったのかを、公式仕様に沿って整理します。
注：社内の実フォーマットはそのまま載せられないので、本記事では汎用の「週次報告書」を例にします。やり方はそのまま自社の書式に置き換えられます。
そもそも Skill（Agent Skill）とは
Skillは、Claudeに「特定の作業のやり方」を覚えさせる再利用可能なパッケージです。中身はとてもシンプルで、
weekly-report-format/
├── SKILL.md ← 必須。手順＋メタ情報（YAMLフロントマター）
├── TEMPLATE.md ← 任意。報告書のひな形
└── examples/ ← 任意。良い例・悪い例など
└── good_sample.md
SKILL.md 1ファイルが本体で、補助ファイル（テンプレや例、スクリプト）は必要に応じて足すだけ。フォルダごとzipにしてアップロードするのが基本の配布単位です。
SKILL.md の先頭には YAMLフロントマターで name と description を書きます（両方とも必須）。
---
name: weekly-report-format
description: 週次報告書を社内標準のフォーマットで作成・整形する。週報・週次レポート・進捗報告を書くときに使う。
---
# 週次報告書フォーマット
以下の見出しを必ずこの順番で出力する：
1. 今週やったこと（実績）
2. 来週やること（予定）
3. 課題・相談したいこと
4. 数値サマリ（KPI）
## ルール
- 各項目は箇条書き。1項目は1〜2行に収める。
- 「課題」は必ず1つ以上書く（「特になし」は禁止。リスクの言語化が目的）。
- 数値サマリは表で出す。前週比を併記する。
- 敬語は常体（だ・である）に統一。
ポイントは description です。後述しますが、Claudeはこの説明文を見て「今このSkillを使うべきか」を自動判定します。だから「何をするか」だけでなく「いつ使うか（週報・進捗報告を書くとき）」まで書いておくのがコツです。
仕様上の細かい制約：
nameは英小文字・数字・ハイフンのみ（最大64字、”claude”・”anthropic” は使えない）、descriptionは最大1024字、本文中に XMLタグは使えません。
作り方：zipにしてアップロードするだけ
Claude Desktop（claude.ai）での手順はこうです。
- 上記のように
SKILL.md（＋必要なら補助ファイル）を入れたフォルダを用意する - フォルダごと zip圧縮する（合計30MB以内）
- Claudeの 設定 → Customize → Skills（カスタマイズ → スキル）を開く
- 「+」→「Upload a skill」 からzipをアップロードする
これで即座に使えるようになります。GUIだけで完結し、いわゆる「skill作成ツール」のようなものはなく、SKILL.md を自分で書いてzipにする、という素朴な作りです。エンジニアからするとむしろ分かりやすいはずです。
利用にはコード実行が有効なプラン（Pro / Max / Team / Enterprise）が必要です。
使い方：明示的に呼ばなくても「自動で」発動する
ここが便利なところで、Skillはコマンドで明示的に呼び出す必要がありません。
普通に「今週の週報書いて。実績はAとB、来週はC」と頼むだけで、Claudeが description を見て「週報の作成だな」と判断し、登録済みの weekly-report-format を自動的に適用してくれます。チームの全員が、特別な呼び出し方を覚えなくていい。これが手戻り削減に効きました。
仕組みは「段階的開示（progressive disclosure）」と呼ばれていて、
- 起動時：全Skillの
name/descriptionだけを読み込む（1つあたり約100トークンと軽い） - 発動時：該当Skillの
SKILL.md本文を読む（約5kトークン） - 必要時：テンプレや例などの補助ファイルを、使うときだけ読む
という三段構え。だからSkillをたくさん登録してもコンテキストを圧迫しにくい設計になっています。
本題：チームへの共有方法（ここに注意点あり）
ここが一番ハマりやすいポイントです。
claude.aiの設定からアップロードしたSkillは、既定ではアップロードした本人だけのものです。自動で組織に共有されたりはしません。チームで使うには、組織オーナー側の設定が要ります。
前提
- プランは Team または Enterprise（個人のPro/Maxでは組織共有はできない）
- 組織オーナーが組織設定で「コード実行・ファイル作成」と「Skills」の両方を有効化していること
共有の2パターン
(A) 個別に共有（P2P）
組織オーナーが「Skill共有」トグルを有効にすると、メンバーが名前やメールを指定して特定の相手にSkillを共有できます。受け取った側は自分のSkill一覧の「Shared with you（共有されたもの）」に出てきて、手動で有効化すると使えます。
(B) 組織全体に公開
組織オーナーが「組織全体へ公開」トグルを有効にすると、Skillを組織のディレクトリに公開でき、メンバーは誰でもそこから見つけて導入できます。
※このルートには承認フローがありません。野放しにしたくない組織は、このトグルはオフのままにして(A)で運用するのが無難です。
そして重要：組織全体のSkillを追加・削除できるのは組織オーナーだけです。一般メンバーが勝手に全社配布することはできません。
私のケースでは、まず(A)で同じチームのメンバーに配って効果を確認し、定着してから(B)で部署に広げる、という順で進めました。
エンジニア向けの補足：配布手段はサーフェスで違う
「Skill」は claude.ai 以外でも使えますが、共有のやり方が異なります。技術チームならむしろこちらが便利なことも。
- Claude API：Skills API（
/v1/skills、ベータヘッダskills-2025-10-02）でアップロードすると、ワークスペース全体で自動的に使える。 - Claude Code：Skillはファイルベース。リポジトリ直下の
.claude/skills/に置いて git に commit & push すれば、git pullしたチーム全員が自動で持つ。個人用なら~/.claude/skills/。
つまり、開発チームで「リポジトリに同梱して配る」なら Claude Code 方式が一番運用が楽です（バージョン管理もレビューもgitに乗る）。一方、非エンジニアも含むチーム全体に配るなら claude.ai の組織共有、という使い分けになります。
注意：Skillはサーフェス間で同期しません。claude.aiにアップしたSkillは、APIで使うには別途アップが必要です。
セキュリティ：Skillは「ソフトを入れる」のと同じ感覚で
Skillはスクリプトを同梱でき、Claudeがそれを実行できます。便利な反面、
- 信頼できる作成元のSkillだけ使う（自作 or 公式）
- 受け取ったSkillは中身（SKILL.md・スクリプト・リソース）を必ず確認する
- 特に外部URLからデータを取りに行くSkillは要注意（取得した内容に悪意ある指示が混ざりうる）
「Skillを入れる＝ソフトをインストールする」くらいの警戒感がちょうどいいです。社内配布するなら、配る前にレビューする運用を決めておくと安心です。
まとめ
- 繰り返し作る社内文書は、フォーマットをSkillにすると書式の手戻りが激減する
- Skillは
SKILL.md（name/description必須）＋任意の補助ファイル。zipにしてアップロードするだけ descriptionに「いつ使うか」まで書くと、明示呼び出し不要で自動発動する- チーム共有はTeam/Enterpriseプランで、組織オーナーの設定が必要（個別共有/全社公開の2通り）
- 開発チームなら Claude Code の
.claude/skills/をgitで配るのが運用しやすい - Skillは実行権限を持つので、信頼できるものだけ・中身を確認してから使う
「毎回同じ書式を口頭で指示している」作業があるなら、それは大体Skill化できます。まずは一番手戻りの多い文書ひとつから試すのがおすすめです。
本記事はClaude／Anthropicの公式ドキュメント（platform.claude.com・support.claude.com）を2026年6月に確認して作成しています。仕様は変更される場合があります。
コメント