AIエージェントがa-blog cmsの作法に沿って制作・開発できるスキル集を公開しました(acms-agent-skills)
2026年11月13日(金)にa-blog cms Ver. 3.2以上のサイト制作とプラグイン(拡張アプリ)開発で使える、AIエージェント向けのスキル集 acms-agent-skills Ver. 1.0.0を公開しました。GitHubのappleple/acms-agent-skillsで、ライセンスはMITです。
Claude CodeやCodex、GitHub Copilot、Cursor、Antigravityなど、Agent Skillsの形式に対応したエージェントにインストールすると、「トップにお知らせの一覧を出して」のような依頼を、a-blog cmsの仕様に合わせて進めてくれます。
公開した背景
AIエージェントにa-blog cmsのテンプレートを書かせると、モジュールの名前や変数、校正オプションの書き方が、一般的なテンプレートエンジンの書き方に引きずられて外れることがあります。Ver. 3.2で標準テンプレートに加えてTwigテンプレートが使えるようになり、どちらのテーマなのかを取り違えるだけでも、書き直しが増えます。
そこで、a-blog cmsで作業するときの判断と注意点を、エージェントが作業の途中で読み込める指示書(スキル)にまとめました。a-blog cms本体のソース(Ver. 3.2.38)と公式ドキュメントdeveloper.a-blogcms.jpで確かめた内容だけを書いています。変数表やチュートリアルは書き写さず、どれを選ぶかの判断、間違えやすい点、公式ドキュメントの案内に絞っています。
スキルとは
スキルは、エージェントが読み込む指示書(SKILL.md)です。エージェントは依頼の内容に合うスキルを自分で選んで読み込むので、インストールしたあとは、いつもどおりに依頼するだけです。スキルの名前を指定する必要はありません。
15のスキル
スキルは3つのプラグインに分かれています。サイトを制作する方は acms-site-builder、プラグイン(拡張アプリ)を開発する方は acms-plugin-developer をインストールします。acms-common は、どちらをインストールしても依存関係として一緒にインストールされます。
acms-common(共通)
スキル | 扱うこと |
|---|---|
acms-router | a-blog cmsに関する依頼を分類し、担当のスキルへ振り分ける |
acms-project-triage | 作業対象のバージョン、テーマの継承、テンプレートの種類(標準・Twig)、プラグインを判定する |
acms-upgrade | バージョンアップの共通の手順と、要修正箇所の洗い出し |
acms-site-builder(サイト制作)
スキル | 扱うこと |
|---|---|
acms-static-to-theme | 静的なHTMLサイトをa-blog cmsのテーマにする(CMS化する)作業を最初から最後まで導く |
acms-theme-development | テーマの構成、継承、template.yaml、大規模サイトの設計と運用 |
acms-template-acms | 標準テンプレートの記法 |
acms-template-twig | Twigテンプレートの記法 |
acms-module-reference | 目的に合うモジュールの選び方、モジュールID |
acms-form | メールフォーム |
acms-custom-field | カスタムフィールド、画像やメディアの入力欄、カスタムユニット |
acms-member-site | 会員制サイトと、会員限定の内容が漏れる経路 |
acms-upgrade-theme | バージョンアップでのテーマの修正 |
acms-plugin-developer(プラグイン開発)
スキル | 扱うこと |
|---|---|
acms-plugin-development | プラグインのPHP実装、独自テーブル、テスト、配布。新しいプラグインを公式のひな型 acms-plugin-skeleton から作る手順も含む |
acms-admin-frontend-plugin | 管理画面のJavaScriptプラグイン(Ver. 3.2.29以降) |
acms-upgrade-plugin | バージョンアップでのプラグインと extension/acms の修正 |
最初に動くのが acms-router と acms-project-triage です。依頼を分類し、作業対象のサイトが標準テンプレートなのかTwigなのかを判定してから、担当のスキルに進みます。
インストール方法
使っているエージェントによって、おすすめのインストール方法が違います。詳しい手順はREADMEのインストールにあります。
Claude Code
プラグインのマーケットプレイスとして追加します。
claude plugin marketplace add appleple/acms-agent-skills
claude plugin install acms-site-builder@acms-agent-skills
claude plugin install acms-plugin-developer@acms-agent-skillsスキルは /acms-site-builder:acms-form のように、プラグイン名付きで表示されます。
そのほかのエージェント
Codex、Cursor、Antigravityなどは、Skills CLIでインストールするのが簡単です。
npx skills add appleple/acms-agent-skillsインストール先のエージェントは、対話で選べます。-a codex のように指定することもできます。GitHub Copilotは、GitHub CLIの gh skill を使う方法がREADMEのおすすめです。
claude.ai(Webとデスクトップアプリ)には、Releasesに添付しているスキルごとのzipを、「設定 > Skills」からアップロードします。
一部のスキルだけインストールするときも、acms-routerとacms-project-triageは一緒にインストールしてください。ほかのスキルがこの2つを前提にしているためです。
インストールしたあとや更新したあとは、新しいセッションを始めると読み込まれます。
依頼の例
READMEには、次のような依頼の例を載せています。
「この静的サイトをa-blog cmsのテーマにして」
「トップページにお知らせの新着を5件出して」
「お問い合わせフォームを作って。電話番号は全角でも受け付けたい」
「エントリーにメイン画像の入力欄を足して」
「このテーマをTwigに移したい」
「会員だけが見られるお知らせのカテゴリーを作って」
「エントリーを公開したらSlackに通知するプラグインを作って」
「このサイトを3.1から3.2に上げたい」
静的サイトのCMS化は、公式チュートリアルの題材でも試せます。
使うときの注意
対象はVer. 3.2以上
スキルが対象にするのはa-blog cms Ver. 3.2以上です。3.1以前のサイトでは、バージョンアップの3つのスキル(acms-upgrade、acms-upgrade-theme、acms-upgrade-plugin)だけが、3.2へ上げる前のサイトも扱います。Ver. 3.2.x の途中で入った機能には、本文に「Ver. 3.2.29以降」のように導入バージョンを注記しています。
a-blog cms本体の開発用ではありません。
Claude Codeのプラグインは自動で更新されない
READMEによると、このマーケットプレイスは既定では自動更新がオフです。更新するときは、先にマーケットプレイスの一覧を更新します。
claude plugin marketplace update acms-agent-skills
claude plugin update acms-site-builder@acms-agent-skills更新しても、開いているセッションは読み込み済みのバージョンを使い続けます。新しいセッションを始めるか、/reload-plugins を実行してください。
同梱のスクリプトは読み取り専用
acms-project-triage、acms-upgrade、acms-static-to-themeには、サイトのファイルを調べるシェルスクリプトが入っています。READMEによると、config.server.php、.env、private/ は読まず、外部への通信もしません。acms-static-to-themeのスクリプトも、指定したディレクトリを読むだけで、ファイルは書き換えません。
AIの回答は公式ドキュメントで確かめる
スキルは、エージェントが間違えやすい点を減らすためのものです。回答が必ず正しくなるわけではありません。テンプレートや設定の内容は、公式ドキュメントと見比べてから、本番のサイトに反映してください。
フィードバック
不具合や要望は、GitHubのIssueで受け付けています。報告には、a-blog cmsのバージョン、使ったエージェントとスキル、依頼した内容、出力のうち誤っていた部分を書いてください。顧客名、サイトのURL、ログイン情報、config.server.php の内容は書かないでください。Pull Requestは現在、社内からのみ受け付けています。