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は現在、社内からのみ受け付けています。

同じタグ付けがされている記事