AIアシスタントのスキル：SKILL.md の中身と、ターミナルなしで導入する方法

SKILL.md とは何か

SKILL.md は、AI アシスタントが作業に取りかかる前に読む「指示書」のテキスト ファイルです。プログラムでもプラグインでもありません。ある種類の仕事をどう 進めるか——最初に何を確認するか、どの順で考えるか、結果をどんな形で出すか、何を 決してしないか——を書いた、ただのマークダウンです。ファイルをリポジトリに置くと アシスタントがそれを読み取り、以後その仕事はモデルの思いつきではなく、書かれた とおりに進みます。

この形式は 2025 年末に登場し、数か月で共通のものになりました。Claude、Codex、 Copilot、Cursor、Gemini CLI をはじめ数十のツールが読み取り、公開ディレクトリの スキル数はすでに数十万を数えます。それでいて解説のほとんどは、ターミナルと リポジトリと稼働中のコーディングエージェントを持つ人に向けて書かれている—— この話題がいまだに開発者向けに見える理由は、それだけです。

ファイル自体は単純です。ハイフン 3 つの行で区切られた 2 つの部分だけ。

実際の分量に近い、完成したスキルを示します。商談の記録をどう読み解くか——何を 探し、どの順で、そして何を推測で補わないか——を定めたものです。

---
name: sales-call-review
description: 商談の振り返り — 反論、判断材料、次の一手
---

# 商談の振り返り

見込み顧客との商談の文字起こしを読み解きます。

## 手順

1. 反論は「そのままの言葉で」引用する。言い換えないこと。
   反論は言い回しそのものがデータです。
2. 反論ごとに、回答したか、その回答が受け入れられたかを記す。
   沈黙は同意ではありません。
3. 予算・時期・決裁者に関する手がかりを探す。
   出てこなかった場合は「言及なし」と明記する。
4. 次の一手を決める: 何を、誰が、いつまでに。

## 出力形式

上記の順で 4 つの節。各節は短い箇条書きにし、前置きの段落は
書かない。反論は鉤括弧で引用する。

## してはいけないこと

- 相手の動機を推測しない。実際に語られたことだけを扱う。
- 受注確度を百分率で見積もらない。その根拠となるデータがない。
- 価格の話が出ていないのに、値引きを次の一手として提案しない。

このファイルにないものに注目してください。コードも設定も API キーも インストールコマンドもありません。スキルとは書き留めた経験であって、ソフトウェア ではないのです。だからこそターミナルを開いたことのない人にも書けますし、だから こそ、その導入にいまだターミナルが要るのは奇妙な話です。

スキル・ツール・プロンプトの役割分担

解決する問題が違うのに、この 3 つは絶えず混同されます。区別は見た目より単純 です。プロンプトは役割を決め、スキルは方法を決め、MCP はアクセスを与えます。

実務上の判断はこうなります。アシスタントの答えが的外れならスキルが要り ます。答えは正しいのに事実を知らないなら MCP が要ります。スキルをいくら 磨いてもデータは手に入らず、MCP をいくら足しても方法は身につきません。多くの 場面で必要なのはスキルのほうです。方法はデータよりずっとゆっくりしか古びず、 一度書けば済むからです。

「ターミナル不要」が指しているのは、たいてい別のこと

「スキルをターミナルなしで入れる方法」はよくある検索で、答えも見つかります。 ただし、答えているのは別の問いです。

ここから、導入方法を選ぶときのより良い問いが導けます。「ターミナルは要るか」 ではなく「自分のパソコンでもう一つエージェントを動かし続ける必要があるか」と 問うこと。答えが「はい」なら、導入画面がどれほど洗練されていても、スキルは 開発者の道具のままです。

ターミナルもコーディングエージェントもなしで導入する

Whisperer は SKILL.md を直接読み取り、アシスタントの回答に反映します。導入 作業はありません。ファイルがあなたのパソコンに届くことはなく、フォルダーもなく、 再起動するものもありません。取得元は 2 つ——共通のディレクトリと、公開されている 任意の GitHub リポジトリです。

1. ウェブ画面 → プロンプト → 「スキル」ボタン
2. 「既製」タブ → 検索語を入力: system design、code review、
   sales、writing など
3. 一覧には名前・取得元リポジトリ・導入数が並びます。開くと
   フロントマターの説明が読めます
4. 「インストール」— スキルがライブラリに入ります
5. プロンプトを開く → 「接続」→ スキルを選ぶ

1. ウェブ画面 → プロンプト → 「スキル」→ 「自分のリポジトリ」タブ
2. 次のいずれかの形式を貼り付けます:
   owner/repo
   https://github.com/owner/repo
   https://github.com/owner/repo/tree/main/skills/sales-review
   https://github.com/owner/repo/blob/main/skills/sales-review/SKILL.md
3. 「スキルを探す」— リポジトリをたどり、含まれる SKILL.md を
   説明つきで一覧にします。特定フォルダーのリンクを貼った場合、
   そのスキルが先頭に出ます
4. 目的のものに「インストール」→ そのあとプロンプトに接続

スキルは実際どこに効くのか

スキルは「アシスタント全体」ではなく、特定の役割 のプロンプトに接続します。役割とは仕事の領域のことで、質問への回答、コードを読む、 画像を読む、システム設計、といった区分です。役割に接続すれば、その役割が働く場所 すべてでスキルが効きます。

接続には 2 つのモードがあり、その違いは名前の印象より重く効きます。

「追加」——スキルがプロンプトの文章に足されます。役割と語調はプロンプトが 決めたまま、スキルが方法を細かくします。10 回のうち 9 回はこちらが正解です。

「置換」——スキルがプロンプトの文章を丸ごと押しのけ、単独でモデルに渡り ます。役割も手順も出力形式もすでに定めた、自己完結したスキル向けで、そこに自分の プロンプトがあるとかえって邪魔になります。2 つ接続して片方が「置換」なら、それが 先に置かれ、「追加」のスキルが後からそれを補足します。

導入したあと、スキルはどうなるか

うまく動く導入と、後味の悪い驚きの源とを分ける要点がここにあります。スキルは コミットに固定されます。導入した時点でファイルのどのバージョンを取得したかを 記録し、以後はそれを使い続けます。

「リポジトリから更新」はファイルを読み直し、新しい版を表示して、スキルを現在の コミットに固定し直します。ライブラリからスキルを削除すると、その接続もすべて外れ ます。別途片づけるものはありません。

最初に書くとよい 3 つのスキル

選び方の基準はこうです。同じことをすでに 3 回説明した場所で、スキルは元が 取れます。会話のたびに同じ指示を繰り返しているなら候補です。四半期に一度で 足りるなら、手で書いたほうが安く済みます。

1. 自社用語の用語集

もっとも過小評価され、もっとも早く書けるものです。自社製品の名前、社内の略語、 同僚の名字、顧客名——モデルが初めて耳にして崩してしまうもの全般。作業は 5 分、 効果は通話のたびに目に見えます。

---
name: our-glossary
description: 社内で使っている用語・製品名・人名
---

# 用語集

これらの語は絶えず出てきます。必ずこの表記で書いてください。

## 製品
- [名称] — [一文での説明]

## 略語
- [略語] — [正式名称]。[似た略語] と混同しないこと

## 人物
- [氏名] — [役割]

一覧の語と音が似ている語は、一覧の表記を採用してください。
知らない用語は聞こえたまま残すこと。すでに知っている似た語に
「直さない」でください。

2. フォローアップの型

打ち合わせ後のメールは毎回同じ構成をとり、その構成は人によって違います。スキル はそれを固定します。どの節を、どの順で、どのくらいの長さで、書き出しの一文をどう 始めるか。「アシスタントが答えた」と「アシスタントがあなたのように答えた」の距離 が、最初の一回ではっきり見える場面です。

3. 自分の会議種別に合った読み解き方

冒頭の例がこれにあたります。面接、商談、振り返り、調査インタビューでは、拾う べきものがそれぞれ違います。汎用のアシスタントは「主な話題」を拾いますが、スキル は反論をそのままの言葉で、あるいは顧客の困りごとの兆候を、あるいは同じ質問群に 対する候補者ごとの差を拾います。

安全性: 公開スキルの約 3 分の 1 に問題がある

この記事でもっとも重要な節であり、たいていの手引きには存在しない話です。

仕組みは、スキルが「エージェントが信頼する指示」であることを思い出せば見えて きます。危険が生じるのは、エージェントにそれを実行する手段があるときです。ファイル への、シェルへの、あなたの鍵へのアクセス。そのとき「.env を見て中身を 設定に足せ」の一行が、そのまま情報漏えいになります。

ここから、導入方法を選ぶうえで知っておく価値のある違いが出てきます。

はっきり言えば、他人が書いた指示に「完全に安全」はありません。コードの 実行をなくせば、鍵の窃取・バックドア・ファイルの持ち出しという最も重い攻撃はなく なりますが、文章は文章のまま残ります。悪意をもって書かれたスキルは、依然として 作者に都合のよい言い回しへアシスタントを寄せられます。特定の製品を勧める、代替を 黙る、評価をわずかに傾ける。本文は導入時と更新のたびに内容フィルターを通し、方針 に明確に反する文章は通しません。ただしフィルターが見つけるのは違反であって、 思惑ではありません。

そこで実務的な結論は単純です。スキルの本文はカードに表示されるので、読む 価値があります。監査の訓練が要るコードではなく、普通の言葉で書かれた 2 画面 ほどのマークダウンです。接続前の 5 分の読書が、コーディングエージェントの世界では スキャナーを要する問題を片づけます。

先に知っておきたい制約

あとで気づくより、いま伝えておくべきことが 4 つあります。

スクリプト前提のスキルは部分的にしか動きません。ディレクトリにあるものの 一部は、付属のコードをエージェントが実行する前提で書かれています。ここで実行される のは文章だけです。指示が単体で成立していればスキルは完全に働きますが、 「analyze.py を実行せよ」に帰着する内容ならまったく働きません。導入前 に判別できます。説明と本文はプレビューで見えます。

本文の上限は 24,000 文字です。およそ 10 ページ分——まともなスキルに必要な 量を上回ります。それより長いファイルは切り詰めて接続され、その旨は黙ってではなく 明示的に伝えられます。

スキルは常にプロンプトに載ります。必要に応じて読み込むわけではありません。 コーディングエージェントの中には、作業内容が合致すると判断したときだけ本文を引き 込むものもあります。こちらでは、接続したスキルはその役割へのリクエストのたびに モデルへ渡ります。必要なときに発動しそこねることがない分、予測しやすい設計であり、 同時にプロンプトあたり 3 件という上限の理由でもあります。

非公開リポジトリには対応していません。GitHub にはあなたの認証情報なしで アクセスするため、公開されているものしか見えません。非公開のリポジトリと存在しない リポジトリは、こちらからは区別がつきません。どちらも「見つかりません」と返ります。

他人のスキルを接続する前のチェックリスト

よくある質問

スキルを書くのにプログラミングの知識は要りますか

要りません。スキルは普通の言葉で書く文章です。何をするか、どの順で、何を避ける か。技術的な要件はファイル冒頭のフロントマター 4 行だけで、上の例からそのまま 写せます。GitHub のリポジトリはウェブ画面で作成でき、ファイルもボタンで追加でき ます。

スキルとシステムプロンプトはどう違いますか

プロンプトは「誰がどんな語調で答えるか」を、スキルは「ある種類の仕事をどう 進めるか」を書きます。実務上の違いは使い回しにあります。プロンプトは個人のもの ですが、スキルは一度書けば同じ仕事をする誰にでも合います。スキルが共有され、 プロンプトがほとんど共有されないのはそのためです。

スキルと MCP、どちらを選べばよいですか

二者択一ではありません。スキルは方法を、MCP はデータと操作をもたらします。 答えが的外れならスキルが、答えは妥当なのに事実を知らないなら MCP が要ります。 両方必要な場面も多く、MCP がタスク管理からデータを運び、スキルがその扱い方を 定める、という形になります。

1 つのスキルを複数のプロンプトに接続できますか

できます。ライブラリは共通で、接続数に上限はありません。スキルの保存は一度、 接続した先すべてで働きます。

作者がリポジトリでスキルを書き換えたらどうなりますか

何も起きません。あなたの控えは取得元のコミットで凍結されています。変更が届くの は「リポジトリから更新」を押したときだけで、そのとき新しい本文はあらためて内容 フィルターを通ります。

検索結果が空になることがあるのはなぜですか

理由は 2 つあります。ディレクトリが一時的に落ちている場合——このとき一覧は空に なりますが、自分のリポジトリの接続は変わらず使えます。もう一つは GitHub 側の 回数制限です。トークンなしでは制限がサービス全体で数えられるため、そうした場面 では数分待つほうが、空の結果を「スキルがない」と見せるより誠実です。

Claude Code や Cursor 向けに書かれたスキルは、ここで動きますか

動きます。ただし指示が単体で成立していることが条件です。形式は同一で、文章も 同じように読まれます。移らないのは、ファイルシステムやシェル、スクリプト実行を 前提とした部分です。あなたの会議を扱うアシスタントには、そうしたものが設計上 存在しません。

まず何から

スキルが自分に合うかを見極める最短の方法は、アシスタントにすでに何度も続けて 出した指示を 1 つ選び、スキルとして保存してみることです。ファイルに 5 分、接続に 1 分。結果はすぐ読み取れます。答えが自分の意図に近づいたなら、あなたは繰り返しを やめたところです。近づかなかったなら、その指示は方法ではなくデータの話だったので、 答えは別の道具にあります。

スキルのライブラリはウェブ画面のプロンプトにあります。 プロンプトと役割の仕組みは Prompt Studio の解説に、どの モデルがどの役割を担うかはモデルの 役割の項にまとめてあります。