EmDashのAgent Skillsとは？入れ方・更新・注意点

はじめに

EmDash（エムダッシュ）は、Cloudflareが開発したCMS（コンテンツ管理システム）です。

AIのコーディングツールでEmDashのサイトを作るとき、AIに今の作り方を教えるために、EmDashが公開しているのが「Agent Skills」です。

AIツールでEmDashのサイトを作っている、またはこれから作ろうと考えている経営者様・ご担当者様もいらっしゃると思います。

この記事では、Agent Skillsとは何か、公式の6つのスキルと使う場面、入れ方、新しく保つ方法、使うときの注意点を順に紹介します。

業種別の使いどころと、よくある質問もあわせて整理します。

なお、この記事で扱うのはCMSのEmDashです。

句読点の「エムダッシュ（—）」や、AIのコーディングエージェントを使うための開発者向けのアプリ「Emdash」とは別のものです。

開発者向けのアプリにもスキルを扱う機能があるため、調べるときは「EmDash CMS」のように添えると見分けやすくなります。

内容は、2026年11月10日時点の公式の情報に基づいています。

対象の版は、EmDash 1.4.0です。

スキルは多くのAIツールで使えます。

この記事は、特定のAIツールを勧めるものではありません。

EmDashそのものの特徴は、EmDashの基本をまとめた記事で解説しています。

EmDashのAgent Skillsとは

EmDashのAgent Skillsは、AIのコーディングツールに、EmDashの今の作り方を教えるための、公式の手順書と参考資料のまとまりです。

コンテンツの項目の設計、記事の取得と表示、プラグイン、管理用のコマンドなどについて、AIがその版の書き方に沿って作業できるようにします。

Agent Skills（共通の形式）とは

Agent Skillsは、AIツールに専門の手順を教えるための共通の形式です。

1つのスキルは、SKILL.mdという説明のファイルを中心にしたフォルダで、参考資料などを一緒に入れられます（Agent Skillsの公式サイト）。

AIは、最初はスキルの名前と説明だけを読み、作業の内容に合うと判断したときに、本文や参考資料を読み込みます。

必要なときだけ読み込む作りのため、いくつものスキルを入れておけます。

この形式は、Anthropicが開発し、オープンな標準として公開したもので、多くのAIツールが対応しています。

EmDashのスキルも、この形式で作られています。

EmDashが公式のスキルを出している理由

EmDashは2026年4月に発表された新しいCMSで、版の更新も速いのが特徴です。

AIの知識は学習した時点のままのことがあり、EmDashの今の書き方を知らない場合があります。

たとえば、サイトを作るスキルには、「画像の項目は文字ではなく、データのまとまりとして扱う」といった注意点がまとめられています。

間違えてもエラーにならず、表示だけが崩れる種類の注意点です（EmDash 1.4.0の公式のスキル）。

公式のスキルの公開場所（emdash-cms/skills）は、EmDashのリリースに合わせて更新されています。

2026年10月の1.1.0・1.2.0・1.3.0・1.4.0のリリースに合わせて、スキルが更新されていることを確認しました（2026年11月10日時点）。

AGENTS.md・Docs MCP・サイトのMCPサーバーとの違い

EmDashのサイトには、スキルのほかにも、AIのための仕組みが用意されています。

役割の違いは次のとおりです。

名前	役割	置き場所・つなぐ先
Agent Skills	EmDash共通の作り方を教える手順書	サイトのフォルダ（.agents/skills/）や、AIツールに入れるファイル
AGENTS.md	そのサイトの作りとルールを伝える説明書	サイトのフォルダに置くファイル。テンプレートに入っている
Docs MCP	EmDashの公式ドキュメントを検索する窓口	公式ドキュメントのサーバー（読み取り専用）
サイトのMCPサーバー	できあがったサイトの記事やページを操作する窓口	自分のサイト（権限の設定が必要）

MCPとは、AIが外部のサービスとやり取りするための共通の決まりです。

スキルとAGENTS.mdはAIへの「説明」、2つのMCPはAIが外部とやり取りする「窓口」と考えると分かりやすくなります。

テンプレートに入っているAGENTS.mdにも、スキルの置き場所と、作業に合わせてスキルを読み込むよう書かれています。

それぞれの仕組みの使い方は、EmDashでサイトを作る流れで整理しています。

EmDashの公式スキル6つと、使う場面

EmDashの公式のスキルは、2026年11月10日時点で6つあります（EmDash 1.4.0の公式ドキュメント）。

ここでは、サイトを作るとき、プラグインを作るとき、EmDashを更新するとき、WordPressから移すときの4つの場面に分けて紹介します。

早見表

公式のスキルと、使う場面は次のとおりです。

スキル	使う場面（公式の説明の要約）	作成のコマンドで作ったサイトに最初から入っているか
building-emdash-site	スキーマ（コンテンツの項目の設計）とシード（初期データ）、コンテンツの取得、本文の表示、メニュー、タクソノミー（分類）、デプロイ	入っている
creating-plugins	隔離して動くプラグインと、ネイティブのプラグインの作成	入っている
emdash-cli	管理用のコマンドでのサイトの管理	入っている
upgrading-emdash	パッケージ、プロジェクトのコード、スキル、データベースの移行を含む更新	入っていない
wordpress-theme-to-emdash	WordPressのテーマをEmDashのサイトへ移すこと	入っていない
wordpress-plugin-to-emdash	WordPressのプラグインの機能をEmDashへ移すこと	入っていない

サイトを作るとき（building-emdash-site・emdash-cli）

サイトを作る場面では、2つのスキルを使います。

building-emdash-siteは、サイトの見た目に関わる部分を作るためのスキルです。

コンテンツの種類と項目の設計、記事の取得と表示、メニューやデプロイ（公開の作業）の設定などを扱います。

emdash-cliは、EmDashの管理用のコマンド（CLI）で、記事や画像、スキーマなどを操作するためのスキルです。

注意したいのは、このスキルが、記事の作成と更新を既定で公開する前提で書かれている点です（EmDash 1.4.0の公式のスキル）。

下書きのままにするには、コマンドに --draft を付ける必要があります。

AIに記事を作らせるときは、「下書きとして保存し、公開はしないでください」と伝えましょう。

公開中のサイトを操作するときは、操作するサイトのURLもはっきり伝えます。

プラグインを作るとき（creating-plugins）

creating-pluginsは、EmDashのプラグインを作るためのスキルです。

プラグインには、隔離された環境で動く形式と、サイトと同じ権限で動くネイティブの形式があります。

スキルは、特別な理由がなければ隔離された形式で作るよう案内しています。

ネイティブの形式は、プラグインの登録先（レジストリ）からは入れられません（EmDash 1.4.0の公式のスキル）。

ただし、隔離された形式のプラグインを動かせるかは、動かす場所と設定によって変わります。

たとえばCloudflareでは、Workersの有料プランで使える機能（Worker Loader）が必要で、作成のコマンドでは初期状態で無効になっています（create-emdash 1.4.0）。

どちらの形式で作るかで、使える機能と、問題が起きたときに影響が及ぶ範囲が変わります。

AIが提案した形式は、選んだ理由とあわせて確かめましょう。

なお、プラグイン用のコマンドの道具（@emdash-cms/plugin-cli）の init で作ったプラグインにも、creating-pluginsが入ります（EmDash 1.4.0の公式ドキュメント）。

EmDashを更新するとき（upgrading-emdash）

upgrading-emdashは、EmDashの公式の更新ツール（upgrade-emdash）の使い方をAIに教えるスキルです。

ツールが作る作業指示書（.emdash/UPGRADE.md）の読み方も含まれます。

このスキルは、依頼の中で頼まれていない場合、データベースへの移行の適用や公開（デプロイ）など、サーバー側を変える作業の前に確認するよう、AIに指示しています（EmDash 1.4.0の公式のスキル）。

更新の流れと、失敗したときの戻し方は、EmDashのアップデートの手順で解説しています。

WordPressから移すとき（2つの移植のスキル）

WordPressから移す場面のスキルは、テーマを移すwordpress-theme-to-emdashと、プラグインの機能を移すwordpress-plugin-to-emdashの2つです。

この2つは、サイトを作るスキルとプラグインを作るスキルを参照する作りです。

そのため公式ドキュメントは、building-emdash-siteとcreating-pluginsも一緒に入れるよう案内しています。

記事や画像の取り込みを含む移行の全体は、WordPressからEmDashへ移行する手順で解説しています。

EmDashのAgent Skillsの入れ方

EmDashのスキルの入手先は2つあります。

作成のコマンド（npm create emdash）で作ったサイトに最初から入っているコピーと、公式のスキルの公開場所（emdash-cms/skills）から入れるものです。

ここでは、それぞれの扱いと入れ方を紹介します。

作成のコマンドで作ったサイトに入っている3つ

作成のコマンドで作ったサイトには、building-emdash-site、creating-plugins、emdash-cliの3つが、.agents/skills/ というフォルダに入っています。

.claude/skills は、同じファイルを指すリンクです。

プロジェクトのスキルに対応したAIツールは、追加の設定なしで読み込みます（EmDashの公式ドキュメント）。

ただし、公式ドキュメントによると、このコピーはサイトを作ったときの版のまま残ります。

更新や移植のスキルも入っていません。

さらに、弊社が2026年11月10日に公開されているファイルを比べたところ、作成のコマンドが取り込むテンプレートのコピーは、公開中の最新のスキル（1.4.0）と内容が一部異なっていました。

サイトを作ったら、まず公式の公開場所から入れ直しておくと確実です。

Skills CLIで入れる（多くのAIツールで共通）

Skills CLIは、Agent Skillsを、さまざまなAIツールに入れるためのコマンドの道具です。

EmDashの開発元ではなく、Vercel（vercel-labs）がオープンソースで公開しています。

EmDashの公式ドキュメントは、対応するツールとして、Codex・Claude Code・Cursor・GitHub Copilot・Gemini CLI・OpenCodeなどを挙げています（2026年11月10日時点）。

入れるときは、サイトのフォルダで次のコマンドを実行します。

• npx skills add emdash-cms/skills

実行すると、入れるスキルと、使っているAIツールを選ぶ質問が出ます。

最初から選んで入れる場合は --skill に続けてスキルの名前を付け、サイトごとではなく自分のアカウント全体に入れる場合は -g を付けます。

サイトごとに入れた場合、入る場所は、多くのツールでは .agents/skills/、Claude Codeでは .claude/skills/ です。

自分のアカウント全体に入れた場合の場所は、ツールごとに異なります（Skills CLI 1.7.6の説明）。

Skills CLIを動かすには、Node.js（サーバーでJavaScriptを動かす仕組み）の22.20.0以上が必要です。

EmDashに必要なNode.js（22.23.4以上）を入れていれば、この条件も満たします（2026年11月10日時点）。

※Skills CLIは、使い方に関する匿名のデータを送る仕組みになっています。止めたい場合は、環境変数（コマンドに設定を渡すための値）に DISABLE_TELEMETRY=1 を設定します。この設定をすると、Skills CLIが行うセキュリティの確認の問い合わせも止まります（Skills CLIの説明）。

AIツールのプラグインとして入れる

いくつかのAIツールでは、EmDashのスキルを、ツールのプラグインとしてまとめて入れることもできます。

入れ方の種類は次のとおりです（2026年11月10日時点の公式の案内）。

入れ方	対応するツール（公式の案内）	入るスキル
AIツールのプラグイン	Codex・Claude Code・GitHub Copilot・Cursor・Factory Droid	プラグインに入っているスキルがまとめて入る
Skills CLI	上のツールを含む、多くのツール	選んだスキル
手動でコピー	.agents/skills/ を読み込むツール	コピーしたスキル

ツールごとのコマンドや画面の操作は変わることがあります。

EmDashの公式ドキュメント（Agent Skills）と、スキルの公開場所の説明（README）で、最新の手順を確かめてください。

入ったかを確かめる

入ったかの確かめ方は、入れた方法によって違います。

Skills CLIでサイトごとに入れた場合は、サイトのフォルダで npx skills list を実行すると、入っているスキルを一覧で見られます。

自分のアカウント全体に -g を付けて入れた場合は、npx skills list -g で確かめます（Skills CLI 1.7.6の説明）。

一覧では、Skills CLIで入れたスキルには入手先が表示され、Skills CLIで入れていないスキル（作成のコマンドで最初から入っていたコピーなど）は「untracked」と表示されます（Skills CLI 1.7.6のプログラムで確認）。

ファイルで確かめる場合、サイトごとに入れたスキルは、サイトのフォルダの .agents/skills/（Claude Codeでは .claude/skills/）にあります。

アカウント全体に入れた場合は、前述のとおり場所がツールごとに異なるため、一覧のコマンドで確かめるほうが確実です。

AIツールのプラグインとして入れた場合は、確かめる場所が変わります。

npx skills list が調べるのは、スキルの置き場所のフォルダだけです（Skills CLI 1.7.6のプログラムで確認）。

プラグインのスキルは、ツールが管理する別の場所から読み込まれることがあるため、一覧やサイトのフォルダに出なくても、入っていないとは限りません。

そのツールのプラグインの一覧で、EmDashのプラグインが入り、有効になっているかを確かめましょう。

そのうえで、AIに「このプロジェクトで使えるEmDashのスキルを、名前と役割で説明してください」と頼んでみましょう。

AIは公式ドキュメントなど別の情報から答えることもあるため、答えは目安として使います。

ツールごとの確認の画面や表示は、それぞれの公式ドキュメントで確かめてください。

Agent Skillsを新しく保つ

スキルの中身も、EmDash本体と同じく版ごとに変わります。

スキルが古いままだと、AIが古い書き方で作業するおそれがあります。

入れた方法によって更新のしかたが違うため、どの方法で入れたかを記録しておきましょう。

入れた方法ごとの更新のしかた

公式の案内による更新のしかたは、次のとおりです（2026年11月10日時点）。

入れた方法	更新のしかた
公式の更新ツール（upgrade-emdash）で本体を更新している	本体の更新に続けて、ツールがスキルも入れ直す（失敗したときは、表示されるコマンドで入れ直す）
Skills CLI	npx skills update（自分のアカウント全体に入れた場合は -g を付ける）
Claude Codeのプラグイン	/plugin marketplace update emdash、または /plugin で自動更新を有効にする
Codexのプラグイン	codex plugin marketplace upgrade emdash
そのほかのツールのプラグイン・手動でコピー	ツールの更新の手順に従うか、入れ直す

スキルの公開場所の説明（README）によると、Claude Codeでは、EmDashのプラグインの配布場所は初期の設定では自動で更新されません。

更新のコマンドを実行するか、自動更新を有効にしておきましょう。

最初から入っていたコピーは「update」では新しくならない

見落としやすいのが、作成のコマンドで最初から入っていた3つのスキルです。

Skills CLIの npx skills update が新しくするのは、Skills CLIで入れたスキルだけです。

Skills CLIは、入れたスキルの入手先を skills-lock.json というファイルに記録し、更新のときはこの記録をもとに作業します（Skills CLI 1.7.6のプログラムで確認）。

テンプレートのコピーには、この記録がありません。

前述の npx skills list で「untracked」と表示されるのが、記録のないスキルです。

そのため、最初の1回は npx skills add emdash-cms/skills で入れ直します。

公式ドキュメントも、テンプレートのコピーを新しくするには、公開場所からスキルを入れるよう案内しています。

公式の更新ツール（upgrade-emdash）で本体を更新した場合は、ツールがこの入れ直しを自動で行います。

入れ直しに失敗したときは、警告と、入れ直すためのコマンドが表示されます。

作業指示書（.emdash/UPGRADE.md）に進む前に、そのコマンドを実行しておきましょう（upgrade-emdash 0.1.0）。

本体の版とスキルの版をそろえる

公式のスキルは、EmDashのリリースに合わせて更新されます。

本体を新しい版にしたら、スキルも新しくしましょう。

反対に、スキルだけを新しくして本体が古い版のままだと、本体にまだない機能や書き方をAIが使おうとするおそれがあります（弊社の見解）。

本体とスキルは、同じ時期にそろえて更新するのが基本です。

また、2つの方法で入れると、同じスキルの古い版と新しい版が並ぶことがあります。

ツールによっては両方を読み込むため、入れ方は1つに決めておきましょう。

点検のタイミング

スキルの版は、EmDash本体を更新したときと、定期の点検のときに確かめます。

3か月ごとなど、定期の点検の項目に「スキルが最新か」を入れておくと確実です。

どの方法で入れたか、最後に更新した日、そのときの本体の版を記録しておくと、点検と引き継ぎが楽になります。

Agent Skillsを使うときの注意点

スキルは、AIへの指示をまとめたものです。

便利な反面、どこから入れたものか、何ができて何ができないかを知らずに使うと、思わぬ作業につながることがあります。

ここでは4つの注意点を紹介します。

公式の公開場所から入れる

EmDashの公式のスキルの入手先は、公式ドキュメントが案内しているemdash-cms/skillsです。

スキルの一覧を集めたサイトには、EmDashの開発元以外が作った、似た名前のスキルも掲載されています（2026年11月10日時点）。

検索結果の上位に出ることもあるため、入れる前に作成者と公開場所を確かめましょう。

また、EmDash本体の公開場所（emdash-cms/emdash）にも、skillsというフォルダがあります。

ここには、公式の6つのスキルの元になるファイルのほかに、コードの点検やドキュメントの執筆など、EmDash本体を開発する人のためのスキルも入っています（2026年11月10日時点）。

サイトを作るときに入れるのは、公式ドキュメントが挙げている6つで、入手先はemdash-cms/skillsです。

ほかの人から受け取ったプロジェクトのスキルにも注意が必要です。

Agent Skillsの公式サイトは、AIツールを作る人向けの案内の中で、信頼できないリポジトリ（プログラムの保管場所）のスキルが、気づかないうちにAIへ指示を差し込むおそれを挙げています。

受け取ったプロジェクトの .agents/skills/ は、中身を確かめてから使いましょう。

スキルは指示であって、権限や安全の仕組みではない

スキルは、AIに「こう作業する」と教えるものです。

AIが実際に何を実行できるかは、AIツールの権限の設定と、つないだアカウントの権限で決まります。

たとえば、更新のスキルは、サーバー側を変える作業の前に確認するようAIに指示しています。

ただし、これはAIが指示を守ることを前提にした約束で、操作を止める仕組みではありません。

公開やデータベースの操作は、AIツールの確認の設定と、依頼の文の両方で押さえておきましょう。

AIツールの権限の設定は、ツールごとの公式ドキュメントで確かめてください。

スキルの初期の動きを知っておく

スキルには、作業の進め方の初期の決まりも書かれています。

その決まりが、自社の運用と合わないこともあります。

前述の、記事を既定で公開する管理用のコマンドのスキルが一例です。

下書きで止めたい場合は、依頼の文で伝えるか、そのサイトのルールとしてAGENTS.mdに書いておきましょう。

スキルが別の道具を使わせることがある

テーマの移植のスキルは、移植元のサイトを表示できる場合に、見比べるための「agent-browser」という別のコマンドの道具を使うよう指示しています（EmDash 1.4.0の公式のスキル）。

AIが新しい道具をインストールしようとしたときは、何を、どこから入れるのかを確かめてから許可しましょう。

Agent Skillsの形式では、スキルにプログラムのファイルを入れることもできます。

弊社が2026年11月10日に確認したところ、EmDashの公式のスキルは説明の文書だけで、実行するプログラムのファイルは入っていませんでした。

ほかのスキルを入れるときは、プログラムが含まれていないかも確かめましょう。

業種別｜スキルを使う場面と、人が決めること

同じスキルでも、業種によって使う場面と、人が先に決めておくことが変わります。

ここでは5つの業種を例に紹介します。

飲食店・小売店

メニューや営業時間のお知らせは、管理用のコマンドのスキル（emdash-cli）を使って、AIに下書きを作らせると手間が減ります。

価格や日付は、人が確かめてから公開しましょう。

工務店・不動産

施工事例や物件の一覧を作るときは、サイトを作るスキル（building-emdash-site）で、コンテンツの項目をAIに作らせます。

間取りや面積、所在地など、載せる項目は作らせる前に人が決めておきます。

写真に個人が特定できるものが写っていないかも、人の目で確かめましょう。

整骨院・クリニック

予約や問診の機能は、プラグインを作るスキル（creating-plugins）で作らせることもできます。

作らせる前に、外部の予約サービスを使うか、送られた内容をどこに保存するかを決めておきましょう。

掲載できる表現には業界ごとのルールがあるため、判断に迷う内容は所管の窓口や専門家にご確認ください。

士業（税理士・社労士・行政書士など）

WordPressのサイトから移る場合は、移植のスキルで、テーマの見た目や機能を移す作業をAIに任せられます。

業務の範囲や報酬の記載は、移した後に専門家として確認してから公開しましょう。

マンション管理組合・団体

担当者が交代しても続けられるよう、スキルをどの方法で入れたか、更新のしかた、最後に更新した日を、AGENTS.mdと引き継ぎのメモに残しておきます。

新しい担当者が同じ方法で更新できれば、古い手順のまま作業されるのを防げます。

EmDashのAgent Skillsに関するよくある質問

EmDashのAgent Skillsについて、出てきやすい疑問にお答えします。

スキルの数や入れ方は変わることがあるため、記載の時点もあわせてご確認ください。

Q: Agent Skillsを入れないと、EmDashのサイトは作れませんか？

必須ではありません。

作成のコマンドで作ったサイトには、3つのスキルが最初から入っています。

スキルは、AIの知識が古いことへの備えとして使うものです。

入れていない場合も、AIに公式ドキュメントの窓口（Docs MCP）で確かめさせながら作れます。

Q: 費用はかかりますか？

公式のスキルは、MITライセンス（改変や再配布の自由度が高いオープンソースのライセンス）で公開されており、無料で使えます。

スキルを読み込むAIツールの料金は、これとは別にかかります（2026年11月10日時点）。

Q: どのAIツールで使えますか？

EmDashの公式ドキュメントは、スキルを入れる道具（Skills CLI）の対応先として、Codex・Claude Code・Cursor・GitHub Copilot・Gemini CLI・OpenCodeなどを挙げています（2026年11月10日時点）。

このほか、いくつかのツールでは、プラグインとしても入れられます。

どのツールでなければ使えない、ということはありません。

普段使っているツールや、会社で利用が認められているツールから選ぶとよいでしょう。

Q: スキルの中身を自分で書き換えてもよいですか？

公式のスキルの公開場所は、EmDashのリリースごとに内容を置き換える作りになっています（公開場所の説明）。

手元のスキルを書き換えても、入れ直したときに元に戻るおそれがあります（弊社の見解）。

サイトに固有のルールは、スキルではなくAGENTS.mdに書いておくのがおすすめです。

Q: 保守を別の会社に頼むとき、スキルについて何を伝えればよいですか？

スキルをどの方法で入れたか、最後に更新した日、そのときのEmDash本体の版を伝えましょう。

AGENTS.mdとあわせて渡すと、引き継いだ人も同じ方法で更新できます。

頼めるかどうかは依頼先の対応範囲によるため、作り方と使っている仕組みを伝えたうえで相談しましょう。

まとめ

EmDashのAgent Skillsは、AIに今の作り方を教える、公式の手順書です。

入れて終わりではなく、本体と版をそろえて新しく保つことが大切です。

この記事の要点を振り返ります。

• 公式のスキルは6つ。作成のコマンドで作ったサイトには3つが入り、作ったときの版のまま残る（2026年11月10日時点・EmDash 1.4.0）
• 入れ方はSkills CLI・各AIツールのプラグイン・手動のコピー。サイトを作ったら、まず公式の公開場所から入れ直す
• 更新は入れた方法に合わせる。最初から入っていたコピーは npx skills update では新しくならない
• 入手先は公式のemdash-cms/skills。スキルは指示であって、権限や安全の仕組みではない
• どの方法で入れたか・最後に更新した日・本体の版を記録し、引き継ぎに備える

ホームページ制作・保守管理のご相談は、株式会社リヒトスまでお気軽にお問い合わせください。