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. The WEEGLOO API and its recommended patterns are updated continuously, so it is a good idea to rerun this command periodically to keep your Skills and Rules current.

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.

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

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.