EmDashのAgent Skillsで何ができますか?

結論

EmDashのAgent Skillsは、Claude CodeやCodexなどのAIに、EmDashでのサイト作り、プラグイン開発、WordPressからの移植の進め方を教える指示と資料です。記事を直接書き換えるMCPサーバーとは役割が別で、導入はコマンド1行から始められます。

EmDashへの移行更新日

EmDashのAgent Skillsにはどんな種類がありますか?

AIに「EmDashでブログを作って」と頼んだとき、AIは何を参考に作業するのでしょうか。その参考書にあたるのがAgent Skillsです。EmDashのAgent Skills一覧には、次の6種類が載っています。

スキル名扱う作業
building-emdash-site項目の設計、初期データ、コンテンツの取得、Portable Text、メニュー、分類、公開先の設定
creating-plugins隔離型とネイティブの2種類のプラグイン開発
emdash-cliコマンドラインからのサイト管理
upgrading-emdashパッケージ、プロジェクトのコード、スキル、コアのデータベース移行を含む更新作業
wordpress-theme-to-emdashWordPressテーマをEmDashサイトへ移す作業
wordpress-plugin-to-emdashWordPressプラグインの動きをEmDashで作り直す作業

ちなみに、npm create emdashで作ったプロジェクトには、building-emdash-site、creating-plugins、emdash-cliの3つが最初から.agents/skills/に入っています。初期同梱のスキルは作成時の版のまま固定されるため、最新の仕様を取り入れたり移植用スキルを追加したりしたいときは、追加の導入コマンドを実行して環境を整えましょう。

Agent Skillsをインストールするには?

たとえば普段使っているCursorやClaude Codeにスキルを追加したい場合、専用のCLIツールを使うと手際よく導入できます。スキルの基本は、指示を書いたSKILL.mdを含むフォルダーです。導入作業は、利用する開発ツールによって手順が分かれますね。

まず、Claude Codeの環境ではプラグインのマーケットプレイスを経由します。/plugin marketplace add emdash-cms/skills を入力し、続けて /plugin install emdash@emdash を実行しましょう。入ったスキルには名前の頭に emdash: が付き、emdash:building-emdash-siteのような名前になります。

Codexを使う場合は codex plugin marketplace add emdash-cms/skills を実行したあと、codex plugin add emdash@emdash で追加します。入れ終わったら、新しいCodexのタスクを開いてから使い始めてください。

Claude Code以外のツールでも使いたい場合は、プロジェクトのフォルダーで npx skills add emdash-cms/skills を実行します。実行中に、入れるスキルと使うAIツールを選べます。配布元の構成はGitHubのスキルリポジトリで公開されており、いつでも最新のファイル構成を確認できますよ。

更新するときは、入れた方法に合わせてコマンドを選びます。

入れた方法更新のコマンド
Skills CLInpx skills update(ユーザー単位で入れたときは -g を付ける)
Claude Codeのプラグイン/plugin marketplace update emdash(/pluginから自動更新も選べる)
Codexのプラグインcodex plugin marketplace upgrade emdash

Studioから移すとき、Agent Skillsはどう役立ちますか?

StudioのサイトをAIがEmDashへ丸ごと運んでくれる、と期待する方もいるかもしれません。ただ、Studioにはデザイン、ページ情報、ソースコード、Studio CMSのモデル構成や記事を書き出す機能がありません(Studioの書き出しに関するヘルプ)。個別にCSVで書き出せるのはフォーム回答だけです。そのため、Agent Skillsは自動で取り込む道具というより、EmDash側でサイトを作り直す作業の手助けになります。

ここで活躍するのが、サイト構築用スキルのbuilding-emdash-siteです。このスキルをAIに読み込ませると、StudioのCMSで設定していた記事の項目やカテゴリー分けを、EmDashのスキーマ定義へ落とし込む作業をスムーズに進められます。たとえば、コレクションやカスタムフィールドの構成、初期投入する記事データを「seed/seed.json」というファイルに記述し、Astroによるページ作成やCloudflareへの配信設定を組み立てていきます。

ただし、ファイルを配置すれば自動的に記事が画面へ反映されるわけではありません。初期のスキーマを反映したあとに、サンプルデータを実際にデータベースへ流し込むための明示的な実行手順が必要です。もうひとつ、Studio時代のURLをEmDashでどう引き継ぐかは、スキルが決めてくれるわけではありません。

YC出身のemdash(コーディングエージェントアプリ)とCloudflareのEmDashは関係ありますか?

スペルが全く同じ「emdash」という名前を掲げているため同一の製品かと思われがちですが、開発元も目的も完全に異なる別々のソフトウェアです。片方はAIのコーディングエージェントを動かすためのデスクトップアプリで、もう片方はWebサイトの記事やページを管理するCMSです。

YC出身のEmdashCloudflareのEmDash
種類コーディングエージェント向けのデスクトップアプリAstroを土台にしたオープンソースのCMS
できること複数のコーディングエージェントを同時に動かすブログ記事、ページ、独自のコンテンツ型を管理する
出どころY Combinator W26の企業Cloudflare
主なURLemdash.sh、emdash.com/docsemdashcms.com、github.com/emdash-cms/emdash

Y Combinatorの支援先として知られるEmdashは、AIエージェントをローカル環境で効率的に動かすためのデスクトップツール。YC側の会社紹介はYCのEmdash紹介ページで見られます。紹介ページのリンク先はemdash.shですが、いまの公式ドキュメントはemdash.comにあります。

一方、ここで取り上げているEmDashは、Cloudflareの技術基盤と親和性が高いWebサイト制作向けのCMSです。この記事で扱っているAgent Skillsは、CloudflareのEmDash向けです。スキルの配布元もemdash-cms/skillsなので、検索で迷ったときは「emdash-cms」という名前が付いているかで見分けがつきます。

こんな聞き方も

  • EmDashのAgent Skillsで何ができますか?
  • emdash agent
  • emdash usage
  • emdash use
  • emdash changelog
  • emdash agent orchestrator
  • emdash ai orchestrator
  • YC出身のemdash(コーディングエージェントアプリ)とCloudflareのEmDashは関係ありますか?

あわせて知りたい(関連する疑問)

QAgent Skillsの不具合はどこに報告しますか?

「スキルの手順どおりにプロンプトを送ったのにエラーが出る」「生成されるコードの指定が古い仕様のままになっている」といった不具合に遭遇したとき、どこへ連絡すればよいか迷ってしまう場面は少なくありません。GitHub上に似た名称のリポジトリが複数存在するため、報告先を取り違えやすいところですね。報告窓口は本体の開発を管理している「emdash-cms/emdash」のリポジトリです。問題の報告(Issueの起票)だけでなく、不具合を直すためのプルリクエストの提出も、すべて本体側のリポジトリへ行います。

コマンドでスキルを導入する際に指定する「emdash-cms/skills」というリポジトリがありますが、こちらは配布専用の場所です。Issueやプルリクエストの受付窓口は設けられていません。配布用リポジトリは本体の「skills/」フォルダーからリリースごとに自動で同期される仕組みになっており、配布用リポジトリ側に直接修正を加えても、次回の同期処理で上書きされて消えてしまいます。

なお、本体リポジトリへ貢献する際のルールはコントリビューション規約で定められています。不具合の修正なら、実装したプルリクエストをそのまま出せますよ。一方で、新しい機能を足したい場合は、実装に入る前に機能計画かRFCの承認を得ておくことが求められます。

Qwordpress-plugin-to-emdashだけ入れれば使えますか?

WordPressで愛用していたプラグインの機能を再現したいとき、wordpress-plugin-to-emdashだけを導入すれば作業を完結できるのでしょうか。1つだけでは足りません。wordpress-plugin-to-emdashはbuilding-emdash-siteとcreating-pluginsの資料を参照するため、この2つも一緒に入れる手順になっています。npx skills add emdash-cms/skillsを実行すると入れるスキルを選べるので、その場で3つにチェックを入れれば済みます。

このスキルは、WordPressの管理画面に入れて動かすプラグインではありません。WordPressプラグインの動きをEmDashで作り直すときに、AIが参照する手引きです。

実際の作業現場では、目的に応じて読み込ませるスキルを切り替えます。プラグインのコードを書く前にはcreating-pluginsを、コレクション、初期データ、クエリ、表示用のテンプレートを変えるときにはbuilding-emdash-siteを読み込みます。入れてあることと、その場面で読み込まれることは別の話です。

初期状態で作成したプロジェクトには、作成時点のbuilding-emdash-siteとcreating-pluginsが含まれています。ただし作成時の版のままなので、移植用のスキルだけ新しい版を入れると、参照先と版がそろわないこともありそうです。移植用を追加するタイミングで、参照先の2つもあわせて入れ直しておきましょう。

QAgent SkillsとMCPサーバーはどう違いますか?

どちらもAIとEmDashをつなぐものですが、働く場面が違います。Agent Skillsは、AIが開発中に読む手順書や資料です。プラグインの組み立て方やフック、WordPressテーマの移し方、CLIでの管理方法などを教えます。

一方、EmDashに入っているサイト用のMCPサーバーは、AIがサイトのコンテンツを直接操作するための接続口です(EmDashのAIツール設定ガイド)。記事の下書きを作る、ページを更新する、メディアを管理するといった、管理画面でできる操作をAIから行えます。ただし、接続した人の権限を超える操作はできません。

それぞれの役割や特徴を見比べると、使い分けのポイントがはっきりします。

項目Agent SkillsMCPサーバー
主な役割作業手順や仕様などの設計ノウハウをAIに教えるサイトのコンテンツ取得や更新を直接実行する
主な提供形態指示書(SKILL.md)を含むフォルダーAPIとして動作する通信サーバー
主な操作対象プログラムコード、設定ファイル、スキーマ下書き記事、固定ページ、メディアデータ
動作の仕組みAIが指示テキストを読み込んでコードを生成するAIが専用エンドポイントを叩いてデータを読み書きする

サイト用MCPは公開済みの記事だけでなく、下書きも扱えますよ。ローカル開発時は手元で動かしている開発サーバーのエンドポイント、本番サイトでは自サイトのドメイン配下のエンドポイントへ接続して利用します。ブラウザで管理画面にログインしているだけでは認証されないため、個人アクセストークンやOAuthによる認証設定を済ませて接続しましょう。また、ドキュメント参照用のMCPと組み合わせて使うことも可能です。

QEmDashの変更履歴はどこで見られますか?

本体や周辺パッケージのアップデートを検討するとき、どのような修正や機能改善が含まれているのかを事前に確かめたい場合はどこを見ればよいでしょうか。最新の更新情報を追うための一次情報は、GitHubの「emdash-cms/emdash」にある公式リリースページです。このページでは、パッケージごと、バージョンごとにリリースノートが個別に掲載されています。CMS本体の変更点を確認したいときは、一覧の中から「emdash」の項目を探して内容を確認します。公式プラグインや関連ツールの項目も同じページに並んでいるため、名前を見てから開くと迷いません。

EmDashのコアパッケージはセマンティックバージョニングの規則に基づいて管理されています。互換性が崩れる変更はメジャーリリースでだけ入り、その内容は変更履歴にはっきり書かれます。メジャーの数字が上がる更新では、変更履歴を読んでから上げたほうがよさそうですね。

自分のサイトにどんな変更が入るかを先に知りたい場合は、プロジェクトのフォルダーで npx upgrade-emdash@latest --dry-run を実行します(EmDashの更新手順)。このコマンドを使うと、実際のファイルを一切書き換えることなく、直接依存している各パッケージの更新予定バージョンと、その更新によって通過する変更履歴の一覧をターミナル上に表示してくれます。

出典

この内容をChatGPTで相談

無料診断