Claude Managed AgentsにGitHubのスキルを読み込ませる方法|EC業務手順を全店舗で標準化する6ステップとSKILL.mdひな形5本【2026年版】

投稿日: カテゴリー Claude

リポジトリスキルとは、GitHubに置いたAI向け手順書のことです。

.claude/skills/rakuten-item-precheck/SKILL.md。Claude Managed Agentsにスキルを読み込ませるとき、ファイルを置く場所はこの形で決まっています。階層が1つ深いだけ、あるいは.claudeの外に置いただけで、エージェントはその手順書を見つけられません。逆に、この置き場所さえ守れば、GitHubのリポジトリ1つを直すだけで、楽天、Amazon、Yahoo!ショッピング、自社ECのすべての店舗のエージェントが同じ手順で動くようになります。本記事は、EC支援19年・5,000社超の実績を持ち、AI導入支援は2023年から提供する株式会社オルセル(うるチカラ運営)の現場知見にもとづいて解説します。公式ドキュメントで確認できた仕様を整理し、EC業務の手順を標準化する6ステップと、そのまま使えるSKILL.mdのひな形5本をまとめました。

リポジトリからのスキル読み込みで変わる3つのこと

リポジトリからのスキル読み込みで変わるのは、アップロードが要らなくなること、手順の更新がコミット1回で済むこと、変更の履歴が残ることの3つです。Claude Managed Agentsは、Anthropicが提供するエージェントの実行基盤で、2026年11月時点でベータ版として提供されています。スキルとは、仕事の進め方や注意点をファイルにまとめ、エージェントが必要なときに読む手順書のことです。

公式ドキュメントによると、スキルをエージェントに渡す方法は2つあります。1つは、スキルをワークスペースにアップロードして、エージェントの設定に登録する方法です。もう1つが、セッションにGitHubのリポジトリをつなぎ、その中のスキルを自動で見つけさせる方法です。セッションとは、エージェントが1つの仕事をする単位を指します。

後者では、セッションの開始時に、リポジトリ直下の.claude/skillsフォルダが調べられます。見つかったスキルは、名前、説明、置き場所の3つがエージェントに伝えられます。手順書の本文は最初から読み込まれるわけではありません。依頼の内容がスキルの説明に合ったときに、エージェントが自分でSKILL.mdを開き、書かれた手順に従います。

アップロードする方法にも2種類あります。Anthropicが用意した既製のスキルと、自分で作るカスタムスキルです。既製のスキルは、PowerPoint、Excel、Word、PDFの4種類の文書を扱うもので、どのワークスペースでも最初から使えます。週次レポートをExcelで出したい、提案書をPowerPointにしたい、といった仕事はこちらが受け持ちます。店舗独自の決まりごとはリポジトリのスキルに書き、文書の作成は既製のスキルに任せる、という組み合わせが使いやすい形です。

この仕組みは、EC運営の現場にある悩みに直接こたえます。複数のモールに出店していると、商品登録のチェック項目やレビュー返信の決まりが、店舗ごと、担当者ごとに少しずつ違ってきます。手順書を1か所に集め、どの店舗のエージェントも同じものを読む形にすれば、ばらつきの原因がなくなります。

数字の面でも確認しておきます。エージェントの設定に登録する方法では、1つのセッションにつき最大500個のスキルを扱えます。リポジトリから見つける方法では、公式のクックブックによると、最初の64個のスキルフォルダまでがエージェントに伝えられます。65個目以降はエラーも出ずに無視されるため、数の管理が欠かせません。Managed Agentsの基本はClaude Managed AgentsでEC業務エージェントを作る解説にまとめています。

EC業務手順を全店舗で標準化する6ステップ

標準化は、業務選び、フォルダづくり、SKILL.mdの作成、権限の設計、動作確認、更新ルールの6ステップで進めます。最初の3つは技術的な知識がなくても進められ、後半の3つでエンジニアか制作会社の手を借りる形が現実的です。

ステップ1:標準化する業務を3つ選ぶ

最初から全業務を対象にせず、3つに絞ります。向いているのは、手順が決まっていて、人によって結果が変わりやすい仕事です。現場で繰り返し見るのは、商品登録前のチェック、レビュー返信の下書き、セール前の価格と在庫の点検の3つで差が出るパターンでした。逆に、値付けや仕入れの判断のように、毎回の状況で答えが変わる仕事は後回しにします。

ステップ2:リポジトリに決まった形でフォルダを作る

置き場所は、リポジトリ直下の.claude/skills/スキル名/SKILL.mdです。スキル名のフォルダは1階層だけで、その中にSKILL.mdを置きます。公式ドキュメントは、見つけてもらえない置き方を3つ挙げています。スキル名のフォルダがなく.claude/skillsの直下にSKILL.mdを置いた場合、フォルダが2階層以上深い場合、.claudeの外のskillsフォルダに置いた場合です。

スキルのフォルダには、SKILL.mdのほかに、参考資料やスクリプトを一緒に入れられます。たとえば商品登録チェックのスキルなら、モールごとの文字数上限をまとめた資料を同じフォルダに置き、SKILL.mdから参照させます。

ステップ3:SKILL.mdを書く

SKILL.mdは、冒頭に名前と説明を書き、その下に手順を書きます。大事なのは説明の1文です。エージェントは説明を見て、今の依頼にこのスキルを使うかどうかを決めます。「商品登録のチェック」だけでは弱く、「楽天の商品登録前に、商品名・説明文・画像の規約違反と文字数超過を確認する。商品登録やCSVアップロードの依頼があったときに使う」のように、何をするかと、いつ使うかの両方を書きます。

説明が長すぎると、2,000文字を超えた部分は切り捨てられます。冒頭の名前と説明を書き忘れた場合は、フォルダ名が名前として使われ、説明は空のまま伝えられます。説明が空だと使われる場面が判断されにくくなるため、書き忘れに注意してください。

ステップ4:書き込める人と承認の流れを決める

ここが最も重要なステップです。公式ドキュメントは、つないだリポジトリはエージェントの信頼の境界の一部になる、と警告しています。リポジトリに書き込める人は誰でもスキルを追加したり書き換えたりでき、その内容は確認の工程なしにセッション開始時に読み込まれます。

EC業務でいえば、レビュー返信のスキルに「次回使えるクーポンを案内する」と1行足されるだけで、モールの規約に触れる返信が全店舗で作られかねません。書き込める人を絞り、変更は責任者の承認を通してから反映する流れを作ります。外部の人が変更を提案できるリポジトリは、スキルの置き場に使わないでください。

ステップ5:セッションにつないで動作を確かめる

セッションを作るときに、リポジトリのURLとアクセス用のトークンを指定します。非公開のリポジトリでは、そのリポジトリを読める権限を持ったトークンが必要です。つないだら、エージェントに「このリポジトリで使えるスキルは何ですか」と聞きます。クックブックの例でも、この質問でスキルの名前と置き場所が返ることを確かめています。

次に、スキルの名前を出さずに仕事を頼みます。「この商品データを登録前に確認して」と頼み、エージェントが最初にSKILL.mdを読んでから作業を始めれば成功です。スキルの発見は、エージェントのファイルを読む機能に頼っています。この機能は標準で有効ですが、止めている場合はスキルが読み込まれません。

ステップ6:更新の流れを決める

手順を変えたいときは、リポジトリのSKILL.mdを直してコミットします。アップロードのやり直しは要りません。ただし、スキルの確認はセッション開始時の1回だけです。動いている途中のセッションには反映されず、次に作るセッションから新しい手順が使われます。

セール期間中のように手順を固定したい時期は、特定のコミットを指定してつなぐ方法が使えます。指定しない場合は、リポジトリの既定のブランチの内容が使われます。お買い物マラソンの直前に手順を直したのに一部の店舗だけ古いまま動いていた、という事態を避けるため、更新したら動いているセッションを作り直す、という決まりをセットにしておきます。

そのまま使えるSKILL.mdひな形5本

ここからは、EC業務向けのSKILL.mdのひな形を5本載せます。中括弧の部分を自店の決まりに置き換えてください。同じ文章は、ChatGPTやGeminiに手順の指示として貼り付けても使えます。編集部でもEC業務向けのスキルを同じ形式で整備しており、ALSEL Agent Skillsで配布しています。

1本目は、楽天の商品登録前チェックです。文字数の上限と規約の確認を1つにまとめています。

ひな形1:楽天の商品登録前チェック

---
name: rakuten-item-precheck
description: 楽天市場の商品登録前に、商品名・キャッチコピー・説明文の文字数超過と規約違反を確認する。商品登録、商品CSVの確認、商品ページの公開前チェックを頼まれたときに使う。
---

# 楽天の商品登録前チェック

1. 商品名が全角換算127文字以内か確認する
2. キャッチコピーが全角換算87文字以内か確認する
3. スマートフォン用商品説明文が全角換算1,280文字以内か確認する
4. 楽天市場の外へ誘導するURL、メールアドレス、電話番号、SNSの案内がないか確認する
5. 根拠のない順位表現、効能を言い切る表現がないか確認する
6. 問題があった項目を、商品管理番号・項目名・理由の組で一覧にする
7. 修正案は出すが、自動では書き換えない

2本目は、レビュー返信の下書きです。特典の示唆や評価変更の依頼を禁じる行を入れています。

ひな形2:レビュー返信の下書き

---
name: review-reply-draft
description: モールのレビューに対する返信の下書きを、店舗の口調と各モールの決まりに沿って作る。レビュー返信、低評価への対応、口コミへのお礼を頼まれたときに使う。
---

# レビュー返信の下書き

1. レビューを高評価、中評価、低評価、クレームの4つに分ける
2. 店舗の口調は「{丁寧/親しみ}」を基本にし、低評価とクレームでは丁寧な敬語にそろえる
3. 返信に、クーポンや特典の案内、評価の変更のお願いを書かない
4. 返金、交換、値引きは約束せず、モール内の問い合わせ窓口への案内に留める
5. 投稿者を特定できる情報を書かない
6. 200文字以内の案を2つ作り、担当者が選べるようにする

3本目は、セール前の価格と在庫の点検です。

ひな形3:セール前の価格・在庫点検

---
name: sale-precheck
description: セール開始前に、対象商品の価格・在庫・クーポン条件の設定ミスを確認する。スーパーSALE、お買い物マラソン、ブラックフライデーなどの事前点検を頼まれたときに使う。
---

# セール前の価格・在庫点検

1. 対象商品の一覧と、セール価格の予定表を突き合わせる
2. セール価格が通常価格より高い、または{下限の割合}%を超えて安い商品を挙げる
3. 在庫数が{基準の数}個未満の商品を挙げる
4. クーポンの対象商品、期間、利用条件が予定表と一致しているか確認する
5. 見つかった問題を、重大、要確認、参考の3段階に分けて報告する
6. 設定の変更は行わず、報告だけを行う

4本目は、問い合わせへの一次回答です。

ひな形4:問い合わせの一次回答

---
name: inquiry-first-reply
description: お客様からの問い合わせに対する一次回答の下書きを、店舗ルールにもとづいて作る。問い合わせメール、配送状況の質問、返品の相談への返信を頼まれたときに使う。
---

# 問い合わせの一次回答

1. 問い合わせを、配送、返品・交換、商品仕様、支払い、その他に分ける
2. 同じフォルダの store-rules.md に書かれた内容だけを根拠に答える
3. ルールに書かれていない内容は答えを作らず、「担当者が確認します」とする
4. 返金と交換の可否は判断せず、担当者への引き継ぎメモを付ける
5. 個人情報を下書きに書き写さない
6. 300文字以内にまとめる

5本目は、週次の売上レポートです。

ひな形5:週次の売上レポート

---
name: weekly-sales-report
description: モールや自社ECの売上データから、週次の売上レポートを決まった形で作る。週次レポート、売上の振り返り、前週比の集計を頼まれたときに使う。
---

# 週次の売上レポート

1. 売上、注文件数、客単価を前週と比べ、増減率を出す
2. 売上が伸びた商品と落ちた商品を、上位5件ずつ挙げる
3. 数値は渡されたデータにあるものだけを使い、計算式を添える
4. 理由の推測は「候補」と明記し、事実と分けて書く
5. 見出しは「全体」「商品別」「来週の確認事項」の3つに固定する
6. A4で1枚に収まる長さにする

5本に共通する書き方のコツを3つ挙げます。1つ目は、手順を番号付きで書き、1行に1つの動作だけを入れることです。長い文章で書くと、途中の条件が読み飛ばされやすくなります。2つ目は、やってはいけないことを手順の中に明記することです。「自動では書き換えない」「返金を約束しない」のような行があると、エージェントが気を利かせて踏み込みすぎる事故を防げます。3つ目は、数値や決まりごとを別のファイルに分けることです。送料や返品条件は変わりやすいので、SKILL.mdに直接書かず、同じフォルダの資料を参照させておくと、直す場所が1か所で済みます。

編集部で実際に運用しているスキルでは、名前は半角の英数字とハイフンだけにし、手順の本文は日本語で書いています。フォルダ名と名前をそろえておくと、どの手順書が使われたのかを後から追いやすくなります。最初の1本は、今ある手順書の中で最も短いものを選んでください。10行ほどのSKILL.mdで動く体験を先に作ると、残りの業務への展開が速くなります。

導入でつまずく4つの失敗と回避策

導入で多い失敗は、置き場所の間違い、スキルの増やしすぎ、権限の甘さ、更新が反映されない勘違いの4つです。どれも仕様を知っていれば防げます。

置き場所の間違いは、エラーが出ないため気づきにくい失敗です。フォルダを整理しようとして.claude/skills/楽天/商品登録/SKILL.mdのように階層を深くすると、セッション開始時には見つけてもらえません。モール別に分けたいときは、rakuten-item-precheckのようにスキル名の先頭にモール名を付けて、1階層のまま並べます。

スキルの増やしすぎにも注意が要ります。伝えられるのは最初の64個までで、超えた分は黙って落とされます。公式ドキュメントは、スキルを多く載せるほどセッションの起動に時間がかかるとも説明しています。業務の種類ごとにリポジトリを分けるか、使っていないスキルを定期的に消すのが定石です。

権限の甘さは、ステップ4で触れたとおり最も危険です。5,000社支援の中で何度も再現したパターンとして、制作会社や元担当者のアカウントに書き込み権限が残り続けるケースがあります。半年に1回、書き込める人の一覧を見直してください。

更新の勘違いは、セール前に起きやすい失敗です。手順を直したら、動いているセッションを作り直すところまでを1つの作業として扱います。同じ名前のスキルがエージェントの設定にも登録されている場合、両方が使える状態になる点も覚えておきましょう。どちらが使われるか分かりにくくなるため、名前の重複は避けるのが無難です。

費用・工数の目安とKPIの置き方

費用は、Managed Agentsの利用料とモデルの利用料が中心で、スキルを読み込むこと自体に追加料金がかかるという記載は公式ドキュメントにありません。ただし、スキルを増やすとその分だけ文脈の枠を使うと説明されています。料金の考え方と上限の決め方はClaude Managed Agentsのセッション予算の解説を参考にしてください。

工数の目安は、3つのスキルを作って動かすまでで、手順の整理に2〜3日、リポジトリの準備と動作確認に1〜2日です(店舗運営の現場感覚にもとづく目安)。すでに紙やスプレッドシートの手順書がある店舗は、それをSKILL.mdの形に直すだけなので、さらに短くなります。

KPIは3つを追います。エージェントの出力を人が差し戻した割合、手順の変更から全店舗への反映までにかかった時間、新しい店舗を立ち上げるときの手順整備にかかった時間です。標準化の効果が最も見えやすいのは3つ目で、既存のリポジトリをつなぐだけで同じ手順が使えるようになります。

手順書がコードと同じ場所で管理される時代へ

今後は、業務の手順書をプログラムと同じ場所で、同じやり方で管理する形が広がると見ています。公式のクックブックは、リポジトリに置くスキルを、コードと一緒に変わる手順に向くものと位置づけています。組織全体で共通に使い、個別に版を管理したい手順は、ワークスペースにアップロードする方法が向くとも説明されています。

EC事業者にとっての意味は、手順の変更に承認と履歴がつくことです。誰が、いつ、どの行を変えたかが残り、問題が起きたら前の版に戻せます。口頭やチャットで伝えていた「今月からレビュー返信の締めの文を変えます」といった連絡が、変更の記録そのものになります。

複数店舗を運営する会社にとっては、新しい担当者や新しい店舗への引き継ぎも変わります。これまでは、ベテランの担当者が口頭で教えた内容が、その人の異動とともに失われることがありました。手順がリポジトリにあれば、新しい店舗のエージェントは初日から同じ基準で動き、新しい担当者はSKILL.mdを読めば店の決まりを把握できます。AIのための手順書が、人のための引き継ぎ資料を兼ねるわけです。

制約も押さえておきます。リポジトリからのスキル発見は、Anthropicのクラウド上の実行環境でのみ動き、自社で用意した実行環境では使えません。データを残さない契約形態にも対応していないとされています。顧客情報を扱う仕事では、エージェントがアクセスできる範囲を絞る設計が前提です。接続先の制限はManaged Agentsの許可ドメイン設定の解説で扱っています。

よくある質問

リポジトリスキルとアップロードするスキルはどちらを選べばよいですか

店舗の業務手順のように頻繁に直すものは、リポジトリスキルが向いています。コミットするだけで次のセッションから反映され、変更の履歴も残るためです。リポジトリをつながないセッションでも使いたい手順は、アップロードする方法を選びます。

エンジニアがいなくても導入できますか

いいえ、セッションの作成とリポジトリの接続にはAPIの操作が必要で、エンジニアか制作会社の協力が要ります。ただしSKILL.mdの中身は文章なので、店舗の担当者が書けます。手順の整理は社内、接続の設定は外部という分担が現実的です。

スキルはいくつまで置けますか

リポジトリから見つけてもらえるのは、最初の64個のスキルフォルダまでです。65個目以降はエラーなしで無視されます。エージェントの設定に登録する方法では、1セッションあたり最大500個です。

手順を更新したのに反映されないのはなぜですか

スキルの確認がセッション開始時の1回だけだからです。動いている途中のセッションには、後からのコミットは反映されません。新しいセッションを作り直すと、更新後の手順が使われます。

非公開のリポジトリでも使えますか

はい、非公開のリポジトリでも使えます。セッションを作るときに、そのリポジトリを読める権限を持ったトークンを指定します。トークンの権限は必要最小限にし、定期的に入れ替えてください。

セキュリティ面で気をつけることは何ですか

リポジトリに書き込める人を絞ることが第一です。スキルは確認の工程なしに読み込まれるため、書き換えられた手順がそのまま全店舗で実行されます。外部から変更を受け付けるリポジトリは、スキルの置き場に使わないでください。

SKILL.mdは日本語で書いても使えますか

はい、手順の本文は日本語で書けます。編集部で運用しているEC業務向けのスキルも、本文は日本語です。名前とフォルダ名は半角の英数字とハイフンにしておくと、置き場所の指定で迷いません。

まとめ

Claude Managed Agentsは、つないだGitHubリポジトリの.claude/skillsフォルダからスキルを自動で見つけ、依頼に合った手順書を読んで作業します。置き場所は1階層の決まった形、伝えられるのは64個まで、確認はセッション開始時の1回、という3つの仕様を押さえれば、手順の更新はコミット1回で全店舗に届きます。まずは商品登録前チェック、レビュー返信、セール前点検の3つをSKILL.mdに書き起こすところから始めてください。書き込める人を絞り、承認を通す流れを先に作っておくことが、標準化を安全に続ける条件です。

参考文献


著者:齋藤竹紘(株式会社オルセル 編集長/5,000社以上のEC支援実績/書籍3冊)


※うるチカラでは、生成AIの導入支援から運用最適化まで、貴社のEC事業に合わせたカスタマイズ提案を行っています。無料相談(30分)も実施中ですので、お気軽にお問い合わせください。
https://uruchikara.jp/contact/


【監修】齋藤竹紘(株式会社オルセル代表 / 19年・5,000社のEC支援実績)


投稿者: 齋藤竹紘

株式会社オルセル代表取締役 / うるチカラ編集長。19年・5,000社以上のEC支援実績を持ち、楽天市場・Amazon・Yahoo!ショッピング・Shopify・Shopee越境ECの実装ノウハウを保有。AI×ECに関する書籍を3冊執筆。「現場で使えるAI実装」を一次情報として発信しています。

お問い合わせ