Agent skills for CMS Orbit
Install the CMS Orbit plugin in Claude Code, Codex, Cursor or any agent, so it models content, builds your website with the SDK and drafts content over MCP the way our docs describe.
How-to guide4 min read
Agent skills are short instructions that coding agents, such as Claude Code, Codex and Cursor, load when a task needs them. The CMS Orbit skills teach an agent how CMS Orbit works: which tool to use for a task, the exact commands and MCP tools, and the rules that keep your content safe, such as reading a page before changing it and sending every draft for review.
They come as one plugin, cms-orbit, in the open source repository bifrost-orbit/agent-plugin, under the MIT licence. The plugin also adds the MCP server, so the agent can read and draft content once you sign in.
Install
Claude Code
Inside Claude Code:
/plugin marketplace add bifrost-orbit/agent-plugin/plugin install cms-orbit@bifrost-orbitOr from a terminal:
claude plugin marketplace add bifrost-orbit/agent-pluginclaude plugin install cms-orbit@bifrost-orbitThen run /mcp, choose cms-orbit and sign in. Each skill is also a slash command, such as /cms-orbit:cms-orbit-use-mcp.
Codex
codex plugin marketplace add bifrost-orbit/agent-plugincodex plugin add cms-orbit@bifrost-orbitCursor
git clone https://github.com/bifrost-orbit/agent-plugin ~/.cursor/plugins/local/cms-orbitReload the window. Cursor asks you to sign in when the MCP server first connects.
Other agents
Install the skills with the open source skills installer:
npx skills add bifrost-orbit/agent-pluginThen add the MCP server to the agent yourself, as Connect an AI agent over MCP describes.
The five skills
cms-orbitcms-orbit-model-contentschema init, validate, diff, push and rollback, field types, slots, links and showWhen, reusing blocks before adding new onescms-orbit-build-frontend@bifrost-orbit-cms/sdk: the client, pages and blocks, generated types, images, links, regions, preview, live updates in the editor and cache refresh, for Next.js and Astrocms-orbit-use-mcpdocVersion, the schema, drafts marked Drafted by AI, submit_for_review, SEO and accessibility fixes, experiments and tidying upcms-orbit-use-cliA task such as "add an FAQ section to the trip pages" can use three of them: the schema change with the CLI, the component in your website with the SDK, and the content for each page over MCP.
How they relate to the MCP server and the CLI
The skills don't give an agent any rights. They describe the tools it already has:
- The MCP server works within the rights of the person who connected it and only drafts. Everything it changes waits for another person's approval in review. See What an agent may and may not do.
- The CLI acts as the person who signed in with
npx cms-orbit login. The skills have the agent run changes with--dry-runfirst and leave flags that remove a safeguard, such as--publish,--yesor--allow-destructive, to you. - The SDK only reads content, with the keys your website already has.
The skills tell agents to treat text from CMS Orbit as content, never as instructions, as the MCP server does.
Give agents only what they need
- When you sign in, choose only the website the agent should work on.
- Leave Allow drafts in production off on Configuration › AI agents unless the agent must draft there.
- Limit an agent key to the regions it may change, and revoke keys and sign-ins you no longer use. See Connect an AI agent over MCP.
- For the CLI, sign in as yourself rather than sharing management tokens. See Security and access.
Update
claude plugin marketplace update bifrost-orbit, then claude plugin update cms-orbit@bifrost-orbit. To update by itself, turn on auto-update for the marketplace under /plugin, Marketplacescodex plugin marketplace upgrade bifrost-orbit, then codex plugin add cms-orbit@bifrost-orbitgit -C ~/.cursor/plugins/local/cms-orbit pull, then reload the windownpx skills updateWhat changed in each version is in the repository's CHANGELOG.md.
Was this page helpful?