Notion Skills APIとは？チームの作業手順を複数のAIで使う方法

何が新しい？Notionが、複数のAIで使う手順の編集場所になる

スキルは、特定の仕事の進め方をまとめた再利用可能な指示です。Notionではページとして編集し、Skills APIでは対応するファイル形式で取り出せます。担当者は普段のNotionで直し、導入担当者がAI側へ配る構成を作れます。出典：Notion公式発表。

たとえば営業担当が提案書の必須項目を直したとき、エンジニアだけが編集できるファイルに変更を頼み続ける必要を減らせます。ただし、Notionを更新すれば、すべてのAIが直ちに最新版を使うわけではありません。配り方を選ぶ必要があります。

3つの使い方を区別する

Notionのデスクトップアプリからは、スキルページの「Download for local agents」で対応するローカルAIへコピーできます。Notion内の「Enable for me」と外部へのダウンロードは別の操作です。出典：公式スタートガイド。

単なるプロンプトのコピペと何が違う？

短い依頼文をコピーするだけなら、特別なAPIは必要ありません。Skills APIが役立つのは、手順に加えて参考資料やファイルをまとめ、AIが読み込める形で配布したい場合です。公式仕様では、スキルの内容をSKILL.mdと添付ファイルを含む形式で取り出せます。出典：Agent Skills API公式仕様。

この仕組みは、AIの出力をすべて同じにするものではありません。同じ基準を配っても、利用するAIや入力によって結果は変わります。

何に使える？手順と参考資料をセットで渡す

たとえば商品紹介の原稿なら、「読者に何を伝えるか」という手順に、製品仕様や表記ルールを添えて管理できます。担当者がNotionで資料を更新し、導入担当者が外部AIへ配布する使い方です。これは当サイトの活用案で、利用実績ではありません。

スキルの例：商品紹介の下書き
手順：対象読者 → できること → 利用条件 → 始め方の順で整理。
参考ファイル：製品仕様、料金表、表記ルール。
出力：各主張の参照元を添えた記事の下書き。
確認：参考資料にない性能や体験を追加しない。

重要なのは、この例の文章そのものではなく、編集可能な手順と根拠資料をセットで配れることです。

最初に試す流れ

1. Notion Agentのチャットで「/」から「+」を選び、スキルを作成します。
2. 繰り返し使いたい手順を記入し、必要な参考ファイルを追加します。
3. 自分のPCで試すなら、対応する環境へ「Download for local agents」でダウンロードします。
4. 読み込ませたAIに対象の仕事を依頼し、指定した手順や資料が使われるか確認します。
5. 継続的に複数人へ配る場合は、次のAPI・CLIの方法を検討します。

作成メニューは公式のスキル作成ヘルプを参照してください。利用先ごとの対応形式や導入方法の確認が必要です。

チームへ配る場合はAPI・CLIが選択肢

公式はVercelのskills CLIによる導入と、GitHubへの同期用スターターを案内しています。CLIの例はnpx skills add <notion url>です。URLはスキルとして設定した自分のNotionページに置き換えます。既存の開発環境を持つ方向けの方法です。出典：公式のCLI紹介。

APIを直接使う場合は、Read content権限を持つ接続トークン等と対象スキルへのアクセスが必要です。APIバージョンの指定も必要で、共有されていないスキルは取得対象に出ません。まず1件の取得を確かめてから同期へ進むと、権限の問題と更新の問題を分けられます。出典：Agent Skills API公式仕様。

Notion公式のGitHub同期サンプルは、導入担当者が自社用の仕組みを作る入口です。一般利用者が記事を読むだけで同期を有効にできるものではありません。共有先と更新担当者を決めてから導入します。

無料で全部使える？何を確認すべき？

Notionのページ編集、Notion AIの実行、外部AIの利用、同期処理の実行環境は分けて確認します。Skills APIの発表だけを根拠に、AIの実行も無制限に無料とは判断できません。必要な機能が現在の契約に含まれるかをNotionの料金ページと利用先AIのプランで確認してください。

1人でたまに使う指示なら、まず短いテンプレートで十分な場合もあります。複数人が手順を直し、複数のAIへ同じ基準を届けたいときに、共同編集と配布の仕組みが役立ちます。

関連：Claude Codeで共通の指示書を使う設定。