Skills and Rules

Connecting MCP to an LLM agent lets the agent call the WEEGLOO API directly. But being able to call an API is not the same as using that API exactly the way WEEGLOO intends. For example, when to use CMA versus CDA, how to design the fields of a Content Type, or which permissions to bind to a Delivery Access Token to keep it secure is not something the call mechanics alone can tell you.

Skills and Rules are two kinds of guidance that close this gap. Skills are guides that capture how to perform a specific task well, and Rules are the rules to follow across all of your work. The install tool (npx weegloo@latest) can install both alongside the MCP connection.

How Skills and Rules differ

Both are information given to the agent, but they play different roles.

Skills are guides that lay out how to perform a specific task, as steps and patterns. There is one per task, and the agent reads and follows the relevant Skill when it starts that task. For example, there are separate Skills for tasks such as designing a Content Type, choosing a service architecture, and issuing a Delivery Access Token. This way the agent follows a proven method instead of guessing.

Rules are rules that must always be followed, regardless of the kind of task. Examples include the base addresses of the WEEGLOO API, how to fetch a resource list page by page, and the fact that you must send version information when updating a resource. The agent applies these rules in the background throughout its work.

In short, Skills are per-task guidance that says "here is how you do this task," and Rules are common rules that say "no matter what task you do, follow this."

Installing

Skills and Rules are installed together by the MCP install tool. Run the following in your terminal.

npx weegloo@latest

When you run it, the tool asks in turn for the environment (agent) to connect to and your Personal Access Token, then installs the Skills and Rules into that environment along with the MCP server. The install process and per-environment setup are covered in Connecting.

Using @latest always installs the latest version. How to bring an existing installation up to date is covered in Keeping up to date.

Keeping up to date

Installing Skills and Rules once is not the end of it. Every time WEEGLOO gains a new capability or changes a recommended approach, this guidance is updated along with it. What is installed on your computer, on the other hand, is a copy taken at the moment of installation, so it stays where it was.

Two things happen when an installation gets old. Skills and Rules that were added later are not in your installation at all, so the agent does not know how to work with those capabilities. If the contents of an item that was already there have changed, the agent follows the older guidance as it stands. Either way, the agent works from the WEEGLOO of the moment you installed it rather than the WEEGLOO of today. The quality of what the agent produces turns on this, so it is worth keeping Skills and Rules current.

What you keep current is the Skills and Rules installed on your computer. The MCP server has nothing to update separately.

The agent tells you when a new version is out. When it starts WEEGLOO-related work, the agent checks the installed version, and shows nothing if that version is already current. Only when there is something to update does it show a notice like the following, together with the command to run.

This update does not run on its own. It rewrites the installed files, so it runs only after you confirm it. When the notice appears, it is best to run the command right then rather than putting it off. Run the command shown in the notice in your terminal exactly as it appears.

The --agent and --location slots carry the environment and the location you chose at install time, so the command differs depending on your installation. Using the command shown in the notice as it appears fills in the right values.

Instead of typing the command yourself, you can tell the agent "update weegloo". The agent already knows which command to run, so you do not have to look it up.

What an update keeps and what it changes

An update is not a fresh install from the beginning. It keeps the choices you made at the first install and brings only the contents up to date.

• The selection of Skills and Rules you made at install time stays as it is. If you installed only some of them, it stays that way.
• Skills and Rules added since your last install are installed along with it automatically. Items you deliberately left out at install time stay left out.
• Items removed from the repository are removed from your computer as well.
• It stays on the version you chose at install time.
• It does not touch the MCP server settings. That is why an update does not require a Personal Access Token.

If you deleted an installed Skill or Rule file by hand, the update installs that file again. To leave an item out, do not delete the file. Run the install command again and clear it on the selection screen.

Updated contents take effect starting from a new conversation. The agent reads the Skills and Rules when a conversation starts, so a conversation already in progress keeps using the previous contents.

Browsing them directly

Skills and Rules live in a public repository. To open what was installed, or to see which guidance exists for which task, refer to the repository.

• Repository: github.com/weeglooapi/weegloo-mcp-plugin

Skills and Rules live under plugins/weegloo/ in the repository, in the skills/ and rules/ directories respectively.

• Skills directory: plugins/weegloo/skills
• Rules directory: plugins/weegloo/rules

When you integrate manually instead of using the install tool, you can take the files at the latest paths above and use them as is.

What to do next

• Connecting: Covers how to install the MCP server, Skills, and Rules for each environment (agent).
• MCP: Covers how the MCP server is configured, along with server groups and the file upload server.