Marionette plugin
A plugin and skill for Codex, Claude Code and Cursor: the agent builds Marionette v5 UIs from the installed version's docs.
- 7,046 ★ on the repository
- Last commit
- MIT
Minimal access
Why this level
- The plugin reads documentation from `node_modules`; the hosted MCP connection receives documentation search queries.
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add plugins/marionetteDetects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewMinimal accessThe tool runs nothing and makes no network calls.
- The plugin reads documentation from `node_modules`; the hosted MCP connection receives documentation search queries.
This is third-party code. Review the repository files before installing.
What it does
Marionette v5 is a JavaScript library for structured interfaces with explicit ownership and lifecycle. The `marionette` npm package ships a `skills/marionette` skill, and the repository carries a plugin of the same name. The skill locates the package installed in the project, reads its version and points the agent to the matching documentation page from that package: quick start, testing, routing, lists, v4 migration. The plugin finds the package itself and loads its skill. For documentation search it connects a hosted MCP server at `https://mcp.marionettejs.com/mcp`, though the local skill works without it.
Who it is for. Front-end teams writing or migrating from v4 Marionette applications who hand part of the work to Codex, Claude Code or Cursor.
Good fit when
- An agent adds a new View to a Marionette application and has to follow the contracts of the installed version.
- An existing v4 application is moved to v5 using the migration guide shipped in the package.
- After a change, cancellation, replacement and teardown of a View must be checked, and the agent takes the recipe from the testing guide.
- An error with a diagnostic code such as MN0003 is decoded with the local documentation helper.
Not a fit when
- The project is written in React, Vue or another framework and has no Marionette in it.
- Only `backbone.marionette` 4.x is installed and no move to v5 is planned.
- The environment forbids external calls and the hosted MCP connection has not been disabled in client settings.
Example request
Add a notification panel to the Marionette app with a dismiss button and check that the View is destroyed after closing.Limitations
The skill targets Marionette v5. For `backbone.marionette` 4.x the loader detects v4 and keeps the work on its contracts; installing the plugin does not upgrade the application. If the installed package has no documentation, the exact release or source revision is needed, and the website is no substitute. The hosted MCP server is checked against the project by version and revision from its catalog, and on a mismatch the local documentation prevails. The plugin ships through repository marketplaces, separately from the npm package.
How to disable. Remove the plugin in client settings or the `skills/marionette` folder from the project. Disable the hosted MCP connection in client settings; the `marionette` package itself stays.
FAQ
Is the plugin needed if the package is already installed?
No. The skill lives inside the package: copy the `skills/marionette` folder from `node_modules/marionette` to the client's skills directory, for example `.agents/skills/marionette` for Codex. The plugin adds automatic package lookup and the hosted MCP connection.
How do I look up an error code?
Run `node node_modules/marionette/skills/marionette/scripts/docs.mjs --diagnostic MN0003`, substituting your code. The helper reads the installed documentation and verifies its hashes.
Does it work in Claude Code and Cursor?
The repository holds marketplace manifests for Codex, Claude Code and Cursor. The README gives no exact command for Claude Code or Cursor, so take it from the client's documentation.
What if the plugin version differs from the package?
Follow the installed package. The plugin version tracks the loader and connection independently of the framework, and API contracts come from the package documentation.
Which Node versions are supported?
Node 22.22.2 and later in the 22.x line and 24.15.0 and later in 24.x are verified. Newer versions may install, but Node 26 is checked separately as advisory.
Discussion
No questions or reviews yet.
Related
PluginsA skill for building premium scroll-driven websites on a real design standard: typography, rhythm, depth, motion and in-browser verification
A Claude Code plugin and skill marketplace for 3D, animation and modern web: Three.js, GSAP, React Three Fiber, Babylon.js
The MagicPath skill finds service UI components via CLI and moves a design into local code, matching the original.
Creative coding skills for Claude Code: motion, micro-interactions and visual systems for web, Android and Apple
45 skills for an agent working with WordPress Bricks through MCP: design system, templates, elements and dynamic data.
The /motion skill and an MCP server with current Motion docs: agents write React and Vue animations from fresh examples.
README in short
Documentation and the skill ship with the package, while diagnostics, types and an ESLint rule help agents check generated code. The agent entry point is `docs/agents.md`.