Skip to content

Install for Claude Code

Claude Code installs Mule Skills as a plugin. Nothing is copied into your project.

Install

/plugin marketplace add Avinava/mule-skills
/plugin install mule-skills@mule-skills

The first command registers this repository as a plugin marketplace. The second installs the plugin from it. Both are one-time.

Install for a whole team by committing the scope to the project instead:

claude plugin marketplace add Avinava/mule-skills
claude plugin install mule-skills@mule-skills --scope project

That writes to .claude/settings.json, so everyone who clones the repository gets the same plugin.

What you get

Eight skills, namespaced under the plugin:

Skill Use it for
mule-api-design HTTP API workshops, RAML/OAS contracts, assessment, Design Center workflow
mule-docs Documentation, architecture, APIs, flows, onboarding, targeted refreshes
mule-development Mule production XML, DataWeave, APIKit implementation, connectors, queues, batch
mule-testing MUnit authoring, repair, fixtures, mocks, assertions, test-only configuration
mule-troubleshooting Incidents, timeouts, connection failures, concurrency, memory
mule-ops Runtime health, deployments, logs, metrics, recurring checks
mule-review Working changes, commits, branches, PRs, release readiness
mule-build Validation, tests, packaging, explicitly requested release actions

Claude selects them from their descriptions, so you can just describe the task. Plugin skills are namespaced, so they appear as mule-skills:mule-review, mule-skills:mule-docs, and so on — use that form to invoke one directly.

Plus three MCP servers — see below.

MCP servers

The plugin bundles credential-free launch configuration for three pinned servers:

Server Pin Role
mule-build @sfdxy/mule-build@2.2.0 Validation, testing, packaging, local runtime, security checks
mule-lint @sfdxy/mule-lint@1.28.0 Canonical Mule standards, static analysis, RAML/OAS validation
anypoint-connect @sfdxy/anypoint-connect@0.12.0 Authorized Design Center, Exchange, Governance, runtime evidence, mutations

Plugin MCP servers start automatically when the plugin is enabled, so the first session after installing pays three npx cold starts. They are cached afterwards. Node.js >=20.19.0 satisfies all three.

mule-build and mule-lint need no credentials. anypoint-connect idles until you authenticate — see anypoint-access.md. Skills that need Anypoint evidence probe the requested capability first and offer setup, supplied exports, or a repository-only scope, so an unauthenticated connector never blocks a session.

The mule-build skill and the mule-build MCP server share a name but are different things: the skill is the workflow (mule-skills:mule-build), the server provides the tools it calls (mcp__mule-build__*). Either can be used without the other.

Run /mcp to see connection status or to disable a server you do not want.

Verify

/plugin

mule-skills should be listed and enabled. Then ask Claude to do something Mule-shaped and confirm it picks up the matching skill.

Update and remove

/plugin marketplace update mule-skills
/plugin update mule-skills@mule-skills
/plugin uninstall mule-skills@mule-skills

Do I still need CLAUDE.md?

Not for routing — Claude discovers plugin skills automatically. You do still want an AGENTS.md holding this project's evidence-backed context, which is what the skills read from. See project-setup.md.