Claudeスキルの作り方|社内の定型業務をスキル化する手順と、配る前の点検

Claudeのスキルとは、決まった仕事の指示や資料をフォルダにまとめておき、必要な依頼のときだけClaudeに読み込ませる仕組みです。社内で作るなら、小さな作業を一つ選び、使う場面と手順を文章にしてから、実際の依頼で試していく流れになります。配る前には、ファイルの中身に加えて、誰が直して誰が承認するかまで決めておきましょう。Claudeでほかに出来ることは、ClaudeのAIエージェント機能のまとめで紹介しています。
スキル化する定型業務の選び方|棚卸しと設計パターン
最初のスキルには、何度も繰り返す仕事で、仕上がりを見て直せるものを選ぶのがよいでしょう。Anthropicの公式ヘルプも、特定の繰り返す作業を一つ解く形を勧めています。部署の仕事を丸ごと任せるより、入力と出力を言葉に出来る作業のほうが、手順をずっと書きやすくなります。まずは直近の仕事の中から、毎回同じ説明をしているものを拾ってみてください。
候補を並べるときは、頻度だけで決めないほうが安心です。毎日ある仕事でも、担当者の判断がその都度大きく変わるようなら、短い指示だけでは同じ結果を出しにくくなってしまいます。反対に、頻度は低くても、引き継ぎのたびに手順を探している仕事なら、文章にしておく価値は充分にあるでしょう。扱う情報に顧客名や人事情報が入っていないかも、作る前に確かめておきたいところです。
| 棚卸しで見る点 | 向いている候補 | 先に人が決めること |
|---|---|---|
| 発生の頻度 | 同じ説明を何度も渡す仕事 | まれな例外まで入れるか |
| 手順の固定度 | 入力、確認、出力の順が決まる仕事 | 判断が分かれる条件 |
| 判断の重さ | 下書きや形式確認を人が最終確認できる仕事 | 最終判断を残す担当者 |
| 情報の機密度 | 架空の例で試せる仕事 | 持ち込めない情報の境界 |
たとえば月次レポートの見出しをそろえる仕事なら、入力は集計済みの数字、出力は決まった順に並んだ文章になります。数字の意味の読み取りや承認までスキルに含めるかどうかは、別に決めましょう。議事録であれば、会議の内容を抜けなく整理する手順と、社外へ送るかどうかの判断を分けて書くことが出来ます。スキルにするのは作業の型で、責任者の判断をなくすことではありません。
1スキル1ワークフローで選ぶ業務別設計パターン
レポート型では、受け取る資料、読み取る項目、完成形の見本をそろえます。売上などの社内データを扱う場合は、見本に実データを写さず、架空の値で形だけ示してください。見出しの順番を決めておき、数字が欠けていたら空欄を勝手に埋めない、と書いておくと試しやすくなります。文章の整え方はスキルに任せ、数字が正しいかどうかは元の資料と照らし合わせる工程を残しておきましょう。
チェックリスト型は、完成物を出す仕事とは少し性格が違います。たとえば社外向けの資料について、会社の書体やロゴの使い方を点検するスキルがこれに当たります。公式の例にも、ブランドの体裁を文書や資料に当てるスキルがあります。確認する項目を並べるだけでなく、問題が見つかったときにどこを示すか、情報が足りないときに何を聞き返すかも書いてみてください。合否を急いで決めるより、担当者がそのまま直せる指摘にしたほうが、現場では役に立つでしょう。
複数ステップ型では、入力を読み、必要な確認をして、形式を整えて返すまでを一つの仕事として扱うことが出来ます。ただ、会議の文字起こしからタスク登録、社外への送信まで一度に任せてしまうと、途中の承認が見えにくくなってしまいます。議事録の整理とタスクの作成は別のスキルとして考え、どこで人に確認を戻すかを決めておきましょう。Anthropicも、作業の流れごとに小さく分ける方法を勧めています。
棚卸しの記録には、対象の業務、使う方、入力の例、完成物の例、確認する方、使ってはいけない情報を書いておくと、後で見返しやすいでしょう。これは製品の必須項目ではなく、社内で候補を選ぶためのメモになります。最初から完璧なマニュアルを目指さず、実際にその仕事をしている方と一緒に、一つの作業を頭からたどってみてください。途中で口頭の判断が出てきたら、その条件を書き留めるところが出発点となります。
Claudeスキルの仕組み|段階的開示と他機能・プランの違い
スキルは、使えるものを毎回すべて読み込む仕組みではありません。Anthropicの説明では、まずスキルの名前と説明を見て、依頼に関係すると判断したものだけ本文を読み、必要に応じて追加の資料へ進む流れになります。この段階的開示を知っておくと、どこに何を書けばよいかが決めやすくなるでしょう。使う方が普段どんな言葉で頼むかを、思い浮かべながら読んでみてください。スキルの種類や使い方の全体像はClaudeのスキルの仕組みと使い方で詳しく紹介しているので、ここでは作るときに必要な部分に絞ってお伝えします。
段階的開示はメタデータ、本文、参照ファイルの順
最初の段階で読まれるのは、nameとdescriptionという短いメタデータです。ここで対象の依頼が伝わらないと、どれだけ丁寧に本文を作っても読まれないかもしれません。次に、手順を書いたSKILL.mdの本文が読み込まれます。さらに細かい資料が必要な場面でだけ、本文から案内したREFERENCE.mdなどを読みに行く形となります。公式の作成ガイドでも、この分け方がスキルの基本として紹介されています。
たとえば議事録のスキルなら、説明には会議メモから議事録を整えることと、どんな依頼で使うかを書きます。本文には、決定事項、未決事項、担当者をどう扱うかを書いていきます。社内の長い書式集は別の資料に置き、必要なときだけ参照させるイメージです。呼び出す条件は短い説明に、作業の順序は本文に、長い資料は別ファイルに置きましょう。
本文を長くし過ぎると、使うたびに読み込む情報も増えてしまいます。Anthropicの作成上の推奨では、本文を500行未満にして、超える分は別のファイルへ分けるよう書かれています。追加資料への参照も深く重ねず、一階層までにするよう案内があります。社内規程をまるごとコピーするのではなく、今回の仕事に必要な部分だけを見分けてみてください。参照している規程が改訂されることを考えると、スキルの更新担当も必要になるでしょう。
MCP・CLAUDE.md・プロジェクトとの違い
プロジェクトは、その中の会話でいつも使う背景知識を置いておく場所です。スキルは、特定の仕事を頼まれたときだけ使う手順になります。カスタム指示は会話全体に広く効く決まりなので、仕事ごとの細かな段取りにはスキルのほうが向いています。毎回使う会社の表記ルールと、議事録のときだけ使う出力の手順を分けて考えると、違いが見えやすいでしょう。
MCPは外部のサービスやデータにつなぐ仕組みで、スキルは作業のやり方を渡す仕組みです。外部のタスク管理サービスへ登録する仕事であれば、接続そのものと、何をどう登録するかの指示は別々に考えることになります。Claude CodeのCLAUDE.mdは常に読み込まれる指示で、スキルの本文は使うときだけ読み込まれます。同じ手順を毎回の会話に載せるべきか迷ったら、使う場面が限られているかどうかを確かめてみてください。
使えるプランと作成方法で違う条件
Anthropicの案内では、スキルはFree、Pro、Max、Ultra、Team、Enterpriseで使えます。使うには、コード実行とファイル作成の設定がオンになっている必要があります。個人の方はSettingsのCapabilitiesでこの設定を確かめ、Customize(新しい画面ではPlugins)からSkillsを探してみてください。TeamとEnterpriseでは組織側の設定も関わってくるため、管理者と一緒に画面を確認しましょう。
作り方によっても、使える条件は変わってきます。手で書く場合は、Markdownという書式のテキストで指示を用意することが出来ます。プログラムを書く知識はなくても大丈夫です。一方で、作業画面を録画して提案してもらう機能はMac版ClaudeのCoworkだけにあり、Pro、Max、Ultra、Teamで使えます。チャット、Windows、Free、Enterpriseではこの録画機能が使えない、というのが公式の説明です。普段のスキルの利用と、録画で作る機能の条件は、混同しないよう気を付けてください。
APIとClaude Codeも同じ形のスキルを扱えますが、作ったものが自動で行き来するわけではありません。APIの自作スキルはSkills APIで上げる形で、APIに上げたスキルは、claude.aiやClaude Codeとは自動で同期しないと説明されています(claude.aiでオンにしたスキルのほうは、同じClaudeアカウントでサインインしたClaude Code(v2.1.273以降)にも読み込まれます)。Claude Codeの場合は、個人のフォルダかプロジェクトのフォルダに置くことになります。どこで使うかを先に決めてから、次の作成手順を選びましょう。
SKILL.mdの構造|name・descriptionと本文を書く
SKILL.mdは、冒頭の設定欄と、その下に書く仕事の手順の2つで出来ています。冒頭の部分はYAMLのfrontmatterと呼ばれ、2本の区切り線の間にnameとdescriptionを置く形になります。claude.aiの作成ヘルプではファイル名をskill.mdと書いていますが、Agent Skillsの仕様やClaude Code、APIの案内ではSKILL.mdとなっています。ここではSKILL.mdの表記にそろえてお伝えします。
nameとdescriptionを具体的に書く
nameは、スキルを見分けるための名前です。仕様では英小文字・数字・ハイフンだけを使い、入れる親フォルダと同じ名前にすることになっています。claude.aiのヘルプには、64文字までという上限があります。たとえばmeeting-notesという名前なら、同じ名前のフォルダにSKILL.mdを入れる形となります。日本語の表示名を考えるより、何の仕事か分かる短い名前を決めてみてください。
descriptionには、何をするスキルかと、いつ使うかの両方を書きます。claude.aiのヘルプでは、上限は200文字と案内されています。Anthropicの作成資料が、三人称で書く形を勧めているのも覚えておきたい点です。利用者に話しかける文ではなく、スキルがどんな入力を受け取り、何を返すかを述べる書き方になります。議事録なら、会議メモを決定事項と未決事項に分けて整え、議事録作成の依頼で使う、といった説明が考えられます。
説明を「文書作成を助けます」だけにしてしまうと、議事録にも報告書にも当てはまり、呼び出される場面がぼやけてしまいます。かといって、部署名や実在の顧客名まで入れなくても、対象の業務と頼み方を具体的にすることは出来ます。descriptionは紹介文であるだけでなく、Claudeがスキルを呼ぶか判断する材料にもなります。試す依頼文に出てくる言葉と説明の言葉がつながっているか、担当者同士で読み合わせてみてください。
本文には入力、順序、出力、止まる条件を書く
本文は、使う方から何を受け取り、どの順に処理して、どんな形で返すかを書く場所です。議事録の例なら、会議名とメモを受け取り、決定事項、未決事項、次に確認することを分けて、会社のひな形の順に返す流れになります。担当者の名前がメモに無いときは推測で補わず、確認が必要だと示す、と書いておくことも出来ます。こうした条件は文章の飾りではなく、実際の出力を点検するときの物差しにもなってくれます。
入力の見本と出力の見本を添えるのも、公式が勧めるやり方です。とはいえ、実在の会議メモをそのまま貼る必要はありません。架空の題材で、どの項目を残して何を省くかが分かる例を作りましょう。見本が立派でも、担当者が実際に渡せる入力とかけ離れていると、テストのときに困ってしまいます。現場で普段使っている言い方を一つ選んで、本文の例をそれに合わせてみてください。
必要なソフトがある場合に書く、dependenciesという任意の設定も案内されています。ただ、初めての社内スキルであれば、まずはテキストの指示だけで充分に試すことが出来ます。スクリプトが要るかどうかは、手順だけでは出来ない処理が見えてから決めましょう。コードが増えるほど、受け取る方が読まなければならないものも増えていきます。資料の参照先と使う条件を短く保つところから始めるのが、自然な順番でしょう。
本文を書く前に、スキルの対象外を一行で決めておく方法もあります。たとえば議事録の整理まではするけれど、社外への送信や最終の承認は担当者へ返す、という線引きです。これはClaudeの必須項目ではなく、社内で手順が混ざらないようにするための工夫になります。作業を任せたい方と確認する方が違う場合、この線引きがないと、完成の意味が人によってずれてしまいます。
手動で作る手順|フォルダ・資料・スクリプト・ZIP
手で作る場合は、仕事の名前を付けたフォルダにSKILL.mdを入れ、動きを試してからZIPにまとめます。フォルダは資料を入れる入れ物、SKILL.mdは作業の指示書、ZIPは配るために一つにまとめた包み、と考えると分かりやすいでしょう。まずはパソコンに新しいフォルダを作り、その中に指示を書いたファイルを置いてみてください。
フォルダとSKILL.mdを手で作る
ここでは例として、議事録を整える仕事にmeeting-notesという名前を付けます。meeting-notesフォルダを作ったら、そのすぐ下にSKILL.mdを置きます。ファイルの先頭にnameとdescriptionを書き、その下に入力、作業の順番、出力の形、迷ったときの扱いをMarkdownで書いていきます。Markdownとは、見出しや箇条書きを記号付きの文字で表す書き方のことです。特別なソフトを使わなくても、普通のテキストとして編集することが出来ます。
完成物の見本を別のファイルにする場合は、本文の中でそのファイル名をはっきり書いてください。同じフォルダに資料があっても、どの場面で何を読むかが分からなければ、期待どおりには使われないかもしれません。指示を足すときは、背景の説明を長くするより、入力が足りないときの確認、出力の項目、最後に人が見る点を先に書きましょう。最後に現場のひな形と見比べて、名前だけの空欄が残っていないかも確かめてみてください。
REFERENCE.mdとスクリプトを足す基準
会社の書式が長い場合は、REFERENCE.mdのような追加の資料に分けることが出来ます。SKILL.mdにはその資料をいつ参照するかだけを書き、詳しい中身は別に置く形になります。資料の版が変わったときにどのスキルが参照しているか追えるよう、ファイル名と担当者を社内で控えておくとよいでしょう。一つのスキルに関係の薄い規程まで詰め込むと、点検する範囲が広がってしまいます。
高度な処理には、PythonやJavaScriptなどのスクリプトを付けることも出来ます。ただ、そのコードが仕事の結果をどう変えるのか説明できないうちは、足さないほうが無難です。Anthropicのヘルプも、まずMarkdownの基本的な指示から始めて、複雑なスクリプトは後から足すよう勧めています。外部のパッケージを使う場合は、何が必要かを確かめる手間も増えてきます。APIで使うスキルは実行中にパッケージを追加できないため、先に入れておく必要があります。
たとえば社内レポートの表を整える仕事でも、文章の並べ替えだけなら指示から始められます。表の数値をプログラムで処理したいなら、入力の形式、おかしな行が来たときの扱い、結果の検算の方法を決めましょう。手順を文章で説明できないうちにコードへ置き換えてしまうと、仕上がりが合わないときに原因を追いにくくなります。コードを入れる前に、手作業で確かめる項目を一度書き出してみてください。
ZIPの階層とアップロードを確かめる
Claudeにアップロードするときは、スキルのフォルダをZIPにまとめます。公式ヘルプの形では、ZIPを開いた最初の階層にmeeting-notesフォルダがあり、その中にSKILL.mdが入っています。SKILL.mdだけをZIPの一番上に置いたり、余分な親フォルダを一段足したりしないよう気を付けてください。フォルダ名とスキル名が合っていないことや、必須のファイルが無いことは、アップロードに失敗する理由として挙げられています。
アップロードの画面へは、Customize(新しい画面ではPlugins)のSkillsから進みます。案内されている順番は、「+」から「+ Create skill」を選び、「Upload a skill」でZIPを渡す流れです。画面の名前が切り替わっている途中なので、社内に手順書を配るときは新旧の表示を並べて書いておくと迷いにくくなります。作業を引き継ぐ方には、ZIPを開いてフォルダの構成を確かめるところまで、一緒に見てもらいましょう。
アップロードの前には、SKILL.mdが分かりやすいか、descriptionが仕事を表しているか、参照するファイルが正しい場所にあるかを確かめます。作れたことと、使う場面できちんと動くことは別の話になります。完成と呼ぶ前に、使うはずの依頼文をいくつか用意しておいてください。ここまでを手順に入れておけば、担当者が変わっても、ZIPを渡しただけで仕事が終わった扱いにはなりにくいでしょう。
skill-creatorと画面録画で作る手順
手順を白紙から書くのが難しい方は、skill-creatorを使って、下書きと試しを行き来しながら作ることが出来ます。Anthropicの公式リポジトリにあるスキルで、新しいスキルを作るだけでなく、今あるスキルを直したり、結果を測ったりする用途が示されています。何をさせたいかを先に決めてから使えば、出てきた案を自分の仕事に照らして判断しやすくなります。まずは棚卸しで選んだ作業について、入力と完成形を一つずつ用意してみてください。
skill-creatorで下書きから評価まで進める
基本の流れは、やらせたい仕事を説明し、下書きを作り、試しの依頼文をいくつか作って実行する順番です。結果を見て足りない指示を直し、もう一度試していきます。失敗を直すたびに、指示を長くする必要はありません。うまくいかなかった場面を具体的に示し、同じ誤りを避けるための短い一文を足すほうが、後から読む方にも伝わりやすくなります。
Claude Codeでは、公式のskill-creatorプラグインを使う方法があります。ターミナルでClaudeを起動して入れる場合、案内されているコマンドは「/plugin install skill-creator@claude-plugins-official」です。VS Codeの拡張機能やデスクトップアプリでは、公式のマーケットプレイスから入れるよう案内されています。社内の非エンジニアの方がターミナルを使わないなら、手で作る手順を先に選んでも構いません。Web版に同じ名前のメニューが最初から出るとは決めつけず、使う環境の案内を確かめてください。
たとえば社内向けの連絡文を整えるなら、元の箇条書きと完成したメールを見せて、変えてはいけない事実を伝えます。skill-creatorが作った説明文をそのまま使わず、どんな依頼で呼ばれるかを声に出して読んでみましょう。社外向けの文と社内向けの文を一つのスキルに入れてしまうと、使う場面が混ざってしまいます。対象を社内の連絡に絞るか、用途ごとに別のスキルへ分けるかを決めてください。
MacのCoworkで画面を録画して作る
普段の作業を画面で見せながら作りたい方には、Mac版ClaudeのCoworkにあるRecord a skillという機能があります。Anthropicの案内では、Pro、Max、Ultra、Teamで使うことが出来ます。チャット画面、Windows、Free、Enterpriseでは、この録画機能は使えません。使えるプランの話は、スキル全体の利用条件とは分けて確認してください。見せたい仕事が画面で伝わる種類のものかどうかも、先に考えておきましょう。
録画の前には、Mac版アプリを最新にして、初回に求められる画面収録などの権限を確かめます。Coworkを開き、入力欄の「+」からRecord a skillを選ぶか、CustomizeのSkillsから追加します。Start recordingで始めて、いつもどおり仕事を進め、終わったらDoneを選ぶ流れになります。途中でやめたいときは、Discardを選べます。録画できるのは約10分までと案内されています。長い仕事であれば、区切りのはっきりした一つの流れを選んでみてください。
作業しながら声で、なぜその項目を先に見るのか、どんな条件なら別の選択肢を取るのかを説明することも出来ます。画面のクリックだけでは伝わらない判断を、言葉にして渡すためです。ただし、画面と声はすべて記録されてしまいます。パスワードや秘密を入力せず、映したくないファイル、アプリ、会話は閉じてから始めてください。顧客の画面をそのまま映すより、架空の資料で同じ手順を見せるほうが、配る前の確認もずっと楽になるでしょう。
Doneを押した後は、Claudeが録画を見て、新しいスキルか、今あるスキルの変更案を出してくれます。新しいものならSave、今あるスキルへの変更ならUpdateを選ぶ前に、Contentで中身を読むことが出来ます。提案が仕事と合っていなければ、Dismissで見送れます。録画の動画と音声は残らない一方で、セッションのスクリーンショットはタスクのRecorded demonstrationで見られ、タスクを消すと一緒に消えるという説明です。出来上がったスキルだけでなく、その記録に何が映っていたかも確かめてみてください。
録画は便利な反面、クリックを見せただけで、例外の扱いや確認する方まで文章になっているとは限りません。出来上がったSKILL.mdのdescription、入力、出力、止まる条件を、手で作ったときと同じ物差しで読み直しましょう。提案を採用する前に、その作業を知っている別の方に説明できるか試してみると、言葉になっていない判断が見つかります。録画で作ったスキルにも、共有の前のテストはやはり必要になります。
定型業務の手順をそろえると、社員がどのAIを使うかも見直しやすくなります。UPGEAR AI(アップギアAI)は、ChatGPT・Claude・Gemini・Perplexityを1つの契約で使える法人向けサービスです(人数無制限)。
テストと改善|複数の依頼文で失敗を見つける
スキルの出来は、ファイルがアップロードできたかではなく、実際の依頼でうまく使われるかで確かめます。Anthropicの作成ガイドでも、例の依頼文をいくつも試して、思考の表示でスキルが読み込まれたかを見るよう案内されています。まずは、使ってほしい依頼と使ってほしくない依頼を、現場の言い方で書き出してみてください。きれいな例文だけで試していると、普段の短い頼み方で呼ばれないという問題が残ってしまいます。
スキルなしの結果を基準にする評価
Anthropicの作成上の推奨には、スキルを作る前に代表的な仕事をスキルなしで頼み、足りない点を記録しておく方法があります。その不足を確かめられる場面を三つ作り、スキルを使った結果と見比べます。たとえば議事録なら、決定事項が混ざったメモ、担当者が書かれていないメモ、未決事項の多いメモを用意することが出来ます。どれも架空の内容にして、元のメモと出力を並べて見てください。
見比べる項目は、目的に合わせて決めます。議事録であれば、決定事項を勝手に増やしていないか、担当者を推測で埋めていないか、会社の書式に沿っているかを見ていきます。レポートなら、元の数値を変えていないか、欠けている項目をはっきり示しているかが見どころです。スキルを使わない結果にも同じ物差しを当てておくと、良くなったのが本当にスキルの指示のおかげなのか、話し合いやすくなります。評価する方には、どこを直したいかを具体的に書き残してもらいましょう。
公式の共有前チェックでは、評価を少なくとも三つ作り、実際の使い方の場面で試すことが挙げられています。Haiku、Sonnet、Opusでも試すよう勧められていて、あるモデルで通った指示が、別のモデルでは説明不足になることがあるという説明です。すべての仕事で同じ結果を求めるより、会社が普段使う環境で必要な条件を満たしているかを確かめてください。評価の記録に、依頼文、期待した結果、実際の結果、直した箇所を残しておけば、次の改訂にもそのまま使えます。
自動起動の失敗とdescriptionの直し方
使うはずの場面でスキルが呼ばれないときは、まずdescriptionを読み直します。仕事の名前だけでなく、依頼のきっかけになる言葉が入っているかを確かめましょう。反対に、別の仕事でも呼ばれてしまうなら、対象を広げ過ぎているのかもしれません。本文をいくら直しても、そもそも本文が読まれていなければ、良くなったかどうかが見えないままになってしまいます。思考の表示で読み込まれたかを確かめ、呼ばれない問題と仕上がりの問題を分けて考えてください。
呼ばれているのに仕上がりが違うときは、入力が足りない、手順の順番があいまい、完成形の例が合っていない、のどれに当たるかを順に見ていきます。たとえば会社名の書かれていないメモから正式な議事録を作ろうとしているなら、名前を推測させるより、確認を求める一文を足すほうがよいでしょう。長い説明を一度に足してしまうと、どの直しが効いたのか分かりにくくなります。1回の改訂で直す失敗は一つにして、同じ依頼文をもう一度試してみてください。
スキルが使えるかどうかは、作った本人の感想だけでは決めにくいものです。作業を知らない方に依頼文を書いてもらうと、社内で普段使う言葉と説明文のずれが見つかることがあります。担当者が完成物に手を入れた箇所も、そのまま改善点になります。Anthropicの推奨にも、チームの意見を反映することが挙げられています。配る前に試してもらう相手を一人決めて、直した理由まで共有しましょう。
よくある失敗は、うまくいった例を一つ見ただけで終わってしまうことです。忙しい日の短い依頼、資料が欠けた依頼、対象外の依頼では、違う動きをするかもしれません。入力がそろった理想の例だけでなく、途中で確認が必要になる例も試してください。失敗が見つかること自体が、テストの成果になります。配った後に使う方が困る前に、どこで人へ戻すかを文章にしておくことが出来ます。
配る前の点検|機密情報と第三者スキルの確認
社内に配る前には、スキルの指示、追加の資料、スクリプト、画面の記録をまとめて見直しておく必要があります。Anthropicは、APIキーやパスワードをスキルに書き込まないことと、ダウンロードしたスキルは有効にする前に中身を確かめることを案内しています。作った本人が読んで問題がなくても、配る先が広がれば、見える範囲も変わってしまいます。まずはフォルダを開いて、どんなファイルが入っているかを一つずつ確かめてみてください。
SKILL.mdに入れない情報の線引き
手順を具体的にしようとするあまり、実際の顧客名、取引先の単価、社員の評価、人事情報を例に写してしまうことがあります。会社の仕事を説明するのに、実名が必ず要るとは限りません。議事録なら架空の出席者、報告書なら架空の売上を使い、構造だけを示すことが出来ます。社外秘の規程を参照する必要があるなら、誰がその資料を使ってよいかを先に決めましょう。ファイルを添付する前に、見本がどこから来たものかも確かめてください。
| 情報の種類 | 見つかりやすい場所 | 配布前の扱い |
|---|---|---|
| APIキー・パスワード | 設定例、スクリプト、画面記録 | スキルに書かず、記録にも映さない |
| 顧客名・取引先名 | 入力例、出力例、参考資料 | 例を架空の内容に替え、実名が必要な仕事は承認範囲を確認する |
| 単価・契約条件 | ひな形、コメント、表 | 手順の説明に不要なら外し、必要な資料の扱いを決める |
| 人事情報 | 評価例、面談メモ | 実データを見本にせず、利用者と確認者を決める |
この表は、製品が自動で分類してくれるという意味ではなく、社内の点検で使う線引きになります。入力してよい情報の決まりを文書にするときは、生成AIの社内ガイドラインの作り方も参考になるでしょう。とくにスクリプトは、画面に見える文章だけでは何をするのか分かりません。何を読み、何を出し、どの外部の先につなぐかまで確かめましょう。Anthropicのヘルプは、外部サービスへの接続には適切なMCPの接続を使うよう案内しています。コードを読める方が社内にいなければ、配るのを急がず、まず文章だけのスキルで目的を果たせるか試してみてください。
録画とスクリーンショットに映るもの
画面から作った場合は、出来上がったSKILL.mdだけを見て終わりにしないことが大切です。録画の動画と音声は残らないと案内されていますが、タスクにはスクリーンショット一式が残ります。画面の端に開いていた会話や、通知で出た名前も、作業の手順とは関係なく映ってしまうことがあります。録画の前に閉じるものを決めておき、終わった後もRecorded demonstrationを見直しましょう。実際の顧客の画面は使わず、練習用の資料で手順を見せる方法も考えてみてください。
声で話す説明にも気を付けたいところです。画面に映していなくても、取引先の名前や社内の未公開の情報を口にすれば、記録に入ってしまいます。録画を始める前に、説明する仕事の範囲と、口にしない固有名詞を紙に書き出しておくことも出来ます。途中で映してはいけないものが出てしまったら、その記録は採用せず、中身を見直すことになります。作るのを早めるための機能だからこそ、記録の素材は先に整えておきましょう。
第三者のスキルは同僚から届いても確認する
スキルの入手元が外部のディレクトリでも同僚でも、フォルダの中身を確かめる点は変わりません。Anthropicの注意書きでは、信頼しきれない提供元のスキルを有効にする前に、同梱のファイル、コードの依存関係、画像やスクリプト、外部のネットワークにつなぐ指示を見るよう求めています。説明文だけを読んで便利そうだと決めず、ファイルの一覧を開いてみてください。
資料やファイルに紛れ込んだ指示で、想定していない動きをさせられる問題は、プロンプトインジェクションと呼ばれます。悪意のあるパッケージのコードによるデータの持ち出しも、公式が挙げているリスクの一つです。社内の方が送ってくれたスキルでも、元はどこから手に入れたものか分からないことがあります。作った本人のものか、公式の提供物か、第三者の持ち込みかを確かめ、分からないものは中身を読める方に回しましょう。
Enterpriseにはスキルとプラグインのセキュリティスキャンがありますが、Teamでは使えません。結果は合格・注意・不合格の3つで示され、不合格のものはブロックされ、Owner・Primary Ownerなど権限のある方が許可しない限り使えないことになります。一方で、スキャンをオンにする前から組織にあったものや、Claudeと一緒に作ったスキルなど、対象外になるものも公式に挙げられています。スキャン結果があっても、業務に合うかと機密の混入は人の目で確かめましょう。自社のプランで何が使えるかを確かめたうえで、スキャンは点検を省く理由にはならないと考えておくのが安心です。
- 中身を開くSKILL.md、追加の資料、画像、スクリプト、依存しているものを一覧で見ます。
- 具体例を読む顧客名、取引先名、単価、人事情報、APIキー、パスワードが紛れていないか確かめます。
- 呼び出しと結果を試すdescriptionと複数の依頼文、使わない場面、入力が足りない場面での動きを試します。
- 配る範囲を決める誰が見てよいか、誰が承認するか、更新の窓口を決めておきます。
チェック欄を埋めること自体を目的にせず、見つかった情報をどう直したかも書き残してください。たとえば実名を架空の名前に替えたなら、どのファイルのどの例を直したかを残しておけます。スクリプトを外した場合は、手順だけで動くかをもう一度試します。点検の後にファイルが変わったら、その版でもう一度確認しましょう。点検で読んだ版と配る版が違っていると、せっかくの確認が意味を失ってしまいます。
属人化を防ぐチーム共有と組織公開|説明文・審査・配布
スキルを社内に渡す方法は、特定の方への共有、組織のライブラリへの公開、オーナーによる配布で扱いが変わります。TeamとEnterpriseでは、作った方が特定の同僚に共有でき、Enterpriseではグループへの共有も案内されています。画面ごとの細かな操作はClaudeのスキルを社内で共有する方法に詳しくまとめているので、ここでは作る側が決めておきたいことを中心にお伝えします。組織に広げる前に、最初に試してもらう相手と、公開した後に誰が管理するかを決めましょう。
個別共有と組織公開の違い
個別共有は、作った方が管理を続けたまま、相手に使ってもらう形です。共有されたスキルは閲覧のみで、受け取った方は有効にして使えますが、中身を編集することは出来ません。作った方が更新すると、受け取った方は次に使うときに新しい版を受け取る仕組みになります。小さく試すなら、まず担当者と確認する方に共有して、手順に足りない言葉を集めてみてください。
組織への公開は、Publish to orgでライブラリへ渡す方法になります。公開すると組織が管理するスキルとなり、更新にも組織の方針が関わってきます。PolicyのPublishingがRequires reviewなら、オーナーなどのレビュー担当が確認してから載る形です。Openならレビューなしで公開され、Offなら公開の操作そのものが出てきません。初期設定はプランやこれまでの組織の設定によって違うため、今のPolicy画面を確かめてください。
Requires reviewの組織では、公開するときに提供のしかたを提案することになります。Available to install、Installed by default、Requiredから選び、レビュー担当がそれを変えることも出来ます。Openの組織では提供のしかたを選ぶ段階がなく、レビューなしでそのまま公開されます(Enterpriseでスキャンがオンなら、合格してから一覧に載ります)。そのため、公開前の社内の点検は自分たちで済ませてから出しましょう。どこまで公開されるか分からないまま操作しないよう、担当者と画面を見比べてみてください。
作成者・確認者・承認者を分けた審査手順
社内の手順としては、作る方が目的と全ファイルをそろえ、業務の確認者が出力を見て、公開の権限がある方が配る範囲を判断する流れが作れます。これはClaudeが求める役職名ではなく、社内で見落としを減らすための分担になります。作る方は依頼文と期待した結果を添え、確認者は元の業務の手順との違いを返します。承認する方は機密と配る先を見て、直しが必要なら作る方へ戻しましょう。
Requires reviewでは、管理画面のRequestsから、出した方、スキャン結果、全ファイル、更新による変更点、似たスキルの候補を見られると案内されています。返すときは、ApproveかRequest changesを選ぶ仕組みです。ただ、画面に情報が並んでいても、業務として正しいかどうかまでは自動で決まりません。たとえば議事録の書式なら、総務など実際に使う部署の方に出力を読んでもらってください。コードが入っているなら、その部分を読める方にも確認を頼みましょう。
オーナーがOrganization settingsのPlugins & skillsから直接スキルを追加して、組織の全員に配る方法もあります。配られたスキルは全員で最初からオンになり、各自でオフにすることが出来ます。Enterpriseでグループ別に配る場合は、スキルをプラグインにまとめてグループに割り当てる形です。全員に必要なものか、特定の部署だけで使うものかを、先に決めてください。部署限定の仕事を全員に配ってしまうと、関係のない依頼で呼ばれることも増えてしまいます。
利用者へ渡す社内向け説明文のひな形
共有の操作が終わっても、使う方に用途が伝わっていなければ、なかなか定着しません。次の文章は製品の画面にある定型ではなく、社内の案内に使うためのひな形です。目的と使い方に加えて、使ってはいけない場面と問い合わせ先も入れてあります。部署名や担当者名を決めてから配り、例の入力は架空の内容に替えてみてください。
このスキルは、会議メモから社内用の議事録案を整えるために使います。会議名とメモを渡し、決定事項と未決事項の整理を頼んでください。担当者や期限が元のメモにないときは、出力を確認し、推測で埋めずに確認者へ尋ねましょう。顧客情報を含むメモ、社外へ送る確定稿、承認が必要な文書は、このスキルの対象外になります。内容の誤りや使えない場面に気づいたら、議事録の担当者へ連絡してください。
説明文は短くても、使わない場面が書いてあると、迷わず判断しやすくなります。とくに共有されたスキルは、受け取った方が編集できないため、不具合に気づいても自分では直せません。問い合わせ先がないと、それぞれが似たスキルを作り、別々の手順が増えてしまうこともあります。誰が直すのかをはっきり書き、試しに使ってもらって出た質問は説明文に反映しましょう。
自作のスキルは、共有するまで同僚からは見えません。管理者に見えるのは名前と共有の状況だけで、ファイルの中身は見えないというのが公式の説明です。管理者だから個人のスキルを全部確認できると思い込まず、審査する版のファイルを出してもらう手順を決めておきましょう。公開済みの一覧はInventoryで見られ、提供のしかたもそこで変えられます。点検の対象と管理画面での見え方を分けて理解しておくと、配る相談もずっと進めやすくなるでしょう。
失敗を防ぐ運用|版管理・担当者・会社の出費
配った後も使い続けるなら、直す担当者、変更の記録、使う方への知らせ方を決めておくとよいでしょう。仕事の書式や用語が変われば、スキルの指示もだんだん古くなってしまいます。Anthropicの推奨でも、時期で変わる情報をむやみに入れないことと、大きく変えるたびに試すことが挙げられています。公開前の確認を一度きりで終わらせず、業務の変更を誰が拾うのか決めておきましょう。
よくある失敗パターンと直す順番
一つ目は、スキルが何でも引き受けるような説明になっていることです。議事録、メール、企画書を一つのdescriptionに並べてしまうと、どの依頼で使えばよいのか分かりにくくなります。まず対象の仕事を一つに絞り、ほかの仕事は別のスキルに分けてください。そうすれば使う方にとっても、名前と説明を読むだけで何を頼めるか分かる形になります。仕事がつながっていても、確認する方が変わるところで分けておくと、引き継ぎもしやすいでしょう。
二つ目は、書式だけを細かく決めて、入力が欠けたときの扱いを書いていないことです。元の資料に担当者名がないのに担当者欄が必須になっていると、見た目だけ整った間違った文書が出来てしまいます。どの項目は空欄のままにするか、何を質問するか、人の確認を待つかを本文に足しましょう。試すときは、欠けのある資料をわざと渡してみてください。完成例を見るより、そのときの振る舞いを見たほうが、運用で困りそうな点を見つけやすくなります。
三つ目は、参考資料を足した後に、どの版を使っているか分からなくなることです。社内のひな形を新しくしても、古いREFERENCE.mdがスキルの中に残っていれば、前の書式が出てくるかもしれません。直すたびに、指示の本文だけでなく、同梱した資料の版も確かめてください。参照する資料を一つのフォルダにまとめ、どの業務の規程に合わせたかを社内の管理メモに書いておけば、誰に確認すればよいかもすぐに分かります。
四つ目は、試す相手が作った本人だけになっていることです。作った方は、あいまいな指示でも意味を自分で補って読めてしまいます。初めて触る方が、同じように読み取れるとは限りません。使う部署の方に短い依頼文で試してもらい、どこで迷ったかを聞いてみましょう。出力は正しくても使い方の説明が足りないなら、社内向けの案内のほうを直すことになります。スキルの本文と案内文は、読む相手が違うものとして別々に確かめてください。
更新・版管理・オーナーの決め方
社内の管理メモには、スキル名、対象の業務、作った方、業務の確認者、今の版、最後に試した依頼文を書いておけます。これは製品が求める欄ではなく、担当が変わったときのための社内の決まりになります。版を変える前には、何を直すのかと、前の版で何に困ったのかを短く残しておきましょう。直した後は、うまくいく例だけでなく、以前失敗した例ももう一度試してみてください。
組織のライブラリに公開したスキルは、作った方が退職してもライブラリに残ると公式に説明されています。ただ、作った方だけが知っている元の資料や確認先は、退職や異動の前に引き継いでおきましょう。自作のスキルは、詳細画面のDownloadから写しを保存することが出来ます。個人のアカウントからTeamやEnterpriseへ移るときは自作のスキルが自動では移らないため、残したいものは移る前に保存しておくよう案内されています。
更新の申請にレビューが必要な組織では、承認されるまでの間、使う方は承認済みの版を使い続けます。現場が急いで新しい書式を使いたいときも、審査中の版が全員に届いたとは思い込まないでください。作る方は変更点と試した結果を出し、確認する方は新旧の違いを見ます。公開した後は、使う方に何が変わったのかを知らせましょう。レビュー担当の方は、Requestsの画面に出る似たスキルの候補(Possible duplicate)も確かめることが出来ます(申請した方には表示されません)。
Claude Codeで使う場合は、個人のフォルダに置く方法と、プロジェクトのリポジトリに入れて、そこで作業する方に共有する方法があります。組織全体には、プラグインや管理設定から配るという説明です。claude.aiでオンにしたスキルが、同じClaudeアカウントでサインインしたClaude Codeに読み込まれる仕組みもありますが、APIキーやAmazon Bedrock経由では同期しません。置き場所が増えるほど、直さなければならない場所も増えてしまいます。どの環境のものを正本にするか、使う部署と開発の担当で決めておきましょう。
料金と社内の手間を会社の出費として見る
費用を考えるときは、スキルを作る時間だけでなく、確認と更新にかかる社内の時間も含めてください。作る方が下書きを用意し、業務の担当が結果を照らし合わせ、管理者が配る範囲を確かめるなら、その分の時間が必要になります。何人分の仕事が減るかを先に決めつけず、作る前の結果と、試した後の直しにかかった時間を記録しておきましょう。外部サービスの料金と社内の作業時間を分けて並べておけば、次のスキルを作るかどうかの判断材料に出来ます。
スキルを使えるプランはFreeからEnterpriseまで案内されていますが、画面録画で作る機能や組織での共有は、使えるプランが違います。単価だけを見てプランを決めてしまい、共有に必要なプランに後から気付くと、会社の見積もりが変わってしまいます。契約の単位と、実際に使う方の範囲を確かめてください。Claudeのプラン料金は契約の条件を確かめ、使う契約の見積書をもとに、会社としての月額を計算しましょう。
社内に必要なのがスキルの共有なのか、複数のAIを使える環境なのかも、目的から分けて選ぶとよいでしょう。よく使う指示と手順を共有したい場面と、社員がAIを切り替えて使う場面とでは、見るべき費用が違ってきます。比べるなら、利用人数、月の利用量、初期費用、作成と点検の担当時間を同じ表に並べてみてください。支出を追うための考え方は、生成AIのコスト管理でも整理しています。人数の増減だけで有利不利を決めず、実際の利用量に合うプランと、運用に必要な人の時間を確かめましょう。
会社の出費を考えるとき、スキル自体が無料だから手間もゼロ、と置いてしまうのも避けたいところです。例の依頼文を作る方、結果を読む方、規程の変更を知らせる方がいれば、それぞれ仕事として時間を使っています。その時間が本当に減るかどうかは、業務ごとに試してみて初めて分かります。最初のスキルは対象を小さくして、同じ仕事をしたときの直しの量を見比べてみてください。次に広げるかどうかは、使う方から届いた直しの声も合わせて決めましょう。
よくある質問
作り方と社内への渡し方で迷いやすい点を、公式の説明に沿ってまとめました。画面の名前が切り替わっている途中なので、管理者と使う方で同じ設定を見ながら進めてみてください。
プログラミングができなくてもClaudeのスキルを作れますか?
SKILL.mdのdescriptionには何を書けばよいですか?
画面録画からスキルを作る機能はWindowsでも使えますか?
作ったスキルを同僚に渡す前に何を確認しますか?
共有と組織への公開は同じですか?
スキルとMCPはどちらを先に考えればよいですか?
最初の一つは、現場がすでに手順を説明できる仕事から選ぶと進めやすくなります。SKILL.mdの説明、実際の依頼文、配る版のファイルを同じ目的にそろえて、使う方の言葉で試してみてください。共有した後も、仕事の決まりが変わったときに直せる担当者を置いておけば、古い手順のまま残ってしまうのを防ぎやすくなるでしょう。
複数のAIを使う環境も、会社の契約で考える
UPGEAR AIは、ChatGPT・Claude・Gemini・Perplexityを1つの契約で使える法人向けサービスです。月額30,000円(税抜)から。どのプランも利用人数は無制限で、料金は利用量に応じたプラン設計です(人数の目安はライト1〜5名、スタンダード6〜20名、プレミアム21〜50名)。
UPGEAR AIの詳細を見る