.skill ファイルを開いて、スキルの中身を見る

そもそも .skill ファイルとは

2026 年 11 月 6 日に、Anthropic のファイルとドキュメントで確かめたことです。

• 中身は ZIP。skill-creator の書き出し用スクリプトは、スキルのフォルダーをフォルダーごと ZIP にして、フォルダーと同じ名前で refund-reply.skill のように書き出します。いちばん上にフォルダーがあり、その中に refund-reply/SKILL.md、必要なら scripts/・references/・assets/ が続きます。
• 書き出す前に確かめている。名前と説明が正しく、フロントマターに決まった項目しかないときだけ書き出します。__pycache__、node_modules、.DS_Store、.pyc のファイルと、いちばん上の evals フォルダーは入れません。
• Claude が手渡してくる。skill-creator の手順書には、claude.ai では Claude がこのスクリプトを動かし、できた .skill ファイルをユーザーがダウンロードする、とあります。
• Claude のヘルプでは ZIP。アップロードの手順は、スキルのフォルダーをいちばん上に置いた ZIP を求めていて、.skill という拡張子には触れていません。.skill ファイルはもともとその形なので、名前を .zip に変えれば、そのまま求められている ZIP です。
• Claude Code では展開して置く。Claude Code はフォルダーからスキルを読みます。自分用は ~/.claude/skills/<名前>/SKILL.md、プロジェクト用は .claude/skills/<名前>/SKILL.md です。

ツールを使わずに .skill ファイルを開く方法

1. Windows：my-skill.skill の名前を my-skill.zip に変え、右クリックして「すべて展開」を選びます（Microsoft のページの表記では「すべて抽出」）。できたフォルダーの SKILL.md をメモ帳で開きます。
2. Mac：名前を my-skill.zip に変え、拡張子を変えるか聞かれたら変える方を選んで、ダブルクリックします。同じ場所にフォルダーができるので、SKILL.md をテキストエディットで開きます。
3. ターミナル（Mac・Linux）：unzip my-skill.skill -d skill-files なら、名前を変えずに展開できます。
4. Claude に入れる：claude.ai かデスクトップアプリで Customize > Skills を開き、「+」→「Create skill」→「Upload a skill」でファイルを選びます。Claude のヘルプは ZIP を求めていて .skill には触れていないので、選べないときは先に .zip に名前を変えます。中身はもともと ZIP です。コード実行をオンにしておきます。
5. Claude Code に入れる：~/.claude/skills/ に展開して、~/.claude/skills/my-skill/SKILL.md になるように置きます。

チェックで見ていること

どれも、Anthropic のページか Agent Skills の仕様に書いてあるルールです。チェックには、アップロードの前に直すことと、その下に知っておくとよいメモが出ます。

• 名前：あること。64 文字まで。半角の小文字、数字、ハイフン（両端と連続を除く）だけで、「anthropic」「claude」を含めない。フォルダーの名前と同じにする。違うと、Claude のヘルプがアップロードのエラーとして挙げている状態です。
• 説明：あること。1,024 文字まで。XML のタグや < > を入れない。200 文字を超えるとメモを出します。Claude のヘルプのカスタムスキルの記事が、claude.ai での上限を 200 文字としているためです。
• フロントマターの項目：name、description、license、compatibility、metadata、allowed-tools だけ。Claude Code のドキュメントによると、claude.ai へのアップロード、Skills API、package_skill.py は、ほかの項目があるとエラーで止まります。Claude Code 自体は、もっと多くの項目を読みます。Claude のヘルプのカスタムスキルの記事は dependencies も任意の項目に挙げているので、この項目はメモにとどめます。
• 置き方：SKILL.md が、アーカイブのいちばん上にあるフォルダー 1 つの中にあること。Claude のヘルプが求める形です。
• 大きさ：SKILL.md が 500 行を超えたとき（仕様は、細かい内容を別のファイルに分けるよう勧めています）と、展開して 30 MB を超えたとき（Skills API の上限）にメモを出します。

名前と説明のルールは、SKILL.md 変換ツールがスキルを書くときと同じです。

「保存してチームと共有する」を押すと

1. SKILL.md のテキストだけを送ります。送り先は AI Skill Pod です。.skill の中のスクリプトや参考資料は手元に残ります。ポッドに残るのはスキルの名前・説明・手順で、フロントマターのほかの項目（license、compatibility、metadata、allowed-tools）は残りません。ほかのファイルから AI に要る内容は、保存したあとにアプリでスキルに書き足します。
2. テキストは 24 時間預かります。その間に、メールで登録するかログインします。この時点では、まだどのポッドにも入っていません。
3. 中身を確かめてから保存します。名前、説明、最初の数行が出るので、「ポッドに保存」を押すとポッドに入ります。新しいポッドは 14日間無料で、カードは要りません。
4. AI をつないで、チームを招待します。Claude・ChatGPT・Cursor をリンク 1 つでつなぎ、スキルを一度試したら、チームに招待リンクを送ります。個人のメールアドレスでもかまいません。

Free プランは、スキル 10 個、メンバー 3 人までです。名前や説明に直すところがあれば、アプリがスキルを入れた状態で自分のフォームを開きます。

よくある質問

.skill ファイルとは何ですか？

Claude のスキルを ZIP にまとめたファイルです。Anthropic の skill-creator が書き出し、中にはスキルのフォルダーがあります。名前・説明・手順を書いた SKILL.md と、スキルが使うスクリプトや参考資料、素材が入っています。

.skill ファイルはどうやって開きますか？

このページのビューアーに置けば、ブラウザの中で読めます。ツールを使わないなら、拡張子を .skill から .zip に変えて展開し（Windows は「すべて展開」、Mac はダブルクリック）、SKILL.md をテキストエディターで開きます。

.skill ファイルを SKILL.md にするには？

SKILL.md はもう中に入っています。ここで開いて「SKILL.md をダウンロード」を押すか、展開してフォルダーから SKILL.md を取り出します。

.skill ファイルを Claude に入れるには？

claude.ai かデスクトップアプリで Customize > Skills を開き、「+」→「Create skill」→「Upload a skill」でファイルを選びます。Claude のヘルプはこのアップロードを ZIP として説明しているので、選べないときは .zip に名前を変えます。コード実行をオンにしておきます。Claude Code なら ~/.claude/skills/ に展開します。

ここで開くと、ファイルはアップロードされますか？

されません。ブラウザが読むだけで、ページは何も送りません。送るのは「保存してチームと共有する」を押したときだけで、送るのは SKILL.md のテキスト、送り先は AI Skill Pod です。

人からもらった .skill ファイルは安全ですか？

Anthropic のドキュメントは、信頼できる出所のスキルだけを使い、そうでないものは同梱のファイルをすべて確かめるよう勧めています。SKILL.md、スクリプト、ほかの資料に、スキルの説明と合わない通信やファイル操作がないかを見ます。このページは中のファイルをすべて並べ、テキストは開いて読めるので、入れる前に確かめられます。

.skill ファイルをチームで共有するには？

Pro や Max などの個人のプランでは、ファイルを送っても、全員がそれぞれアップロードし、直すたびに入れ直します。Team と Enterprise では、同じ Claude の組織の同僚に閲覧専用で共有でき、オーナーは全員にスキルを配れますが、ChatGPT や Cursor、自分のアカウントで働く外注先には届きません。AI Skill Pod ならスキルは 1 つのポッドにあり、招待リンクで入ったメンバーが、自分の Claude、ChatGPT（Pro・Business・Enterprise）、Cursor から使えます。