Skills と Rules
LLM エージェントに MCP を接続すると、エージェントは WEEGLOO API を直接呼び出せるようになります。ただし、API を呼び出せることと、その API を WEEGLOO が意図したとおりに正確に使うことは別です。たとえば、どの状況で CMA を使い、どの状況で CDA を使うべきか、Content Type のフィールドをどう設計すべきか、Delivery Access Token にどの権限を紐付ければ安全かは、呼び出し方だけではわかりません。
Skills と Rules は、このギャップを埋める 2 種類の案内です。Skills は特定の作業をうまく実行する方法をまとめたガイドで、Rules は作業全体で守るべきルールです。インストールツール(npx weegloo@latest)が、MCP 接続とあわせてこの 2 つを一緒にインストールできます。
Skills と Rules の違い
どちらもエージェントに与える情報という点では同じですが、役割が異なります。
Skills は、特定の作業をどう実行するかを手順とパターンで整理したガイドです。作業ごとに 1 つずつあり、エージェントはその作業を始めるときに該当する Skill を読んで従います。たとえば Content Type の設計、サービス構成の選択、Delivery Access Token の発行といった作業に、それぞれ Skill があります。エージェントは推測の代わりに、検証済みの方法に従うようになります。
Rules は、作業の種類に関係なく常に守るべきルールです。たとえば WEEGLOO API のベースアドレス、リソース一覧をページ単位で取得する方法、リソースを更新するときにバージョン情報をあわせて送る必要があるといったことです。エージェントは作業の間ずっと、このルールを背景として適用します。
整理すると、Skills は「この作業はこうする」という作業別の案内であり、Rules は「どの作業をするときでもこれは守る」という共通のルールです。
インストールする
Skills と Rules は、MCP インストールツールがあわせてインストールします。ターミナルで次を実行します。
npx weegloo@latest実行すると、接続する環境（エージェント）と Personal Access Token を順に尋ね、MCP サーバーとあわせて Skills・Rules をその環境にインストールします。インストールの手順と環境ごとの設定は 接続する で扱います。
@latest を使うと、常に最新バージョンがインストールされます。WEEGLOO API と推奨パターンは継続的に更新されるため、このコマンドを定期的に再実行して、Skills と Rules を最新の状態に保つことをおすすめします。
自分で確認する
Skills と Rules は公開リポジトリに入っています。インストールされた内容を自分で開いて確認したり、どの作業にどの案内があるかを調べたりするには、リポジトリを参照します。
Skills と Rules は、リポジトリの plugins/weegloo/ 配下に、それぞれ skills/ と rules/ ディレクトリとして入っています。
- Skills ディレクトリ: plugins/weegloo/skills
- Rules ディレクトリ: plugins/weegloo/rules
インストールツールを使わずに直接連携する場合も、上記の latest パスのファイルをそのまま取得して使えます。