Agent Skill

The atlas plugin packages everything an AI coding agent needs to work with Atlas CMS:

• The Atlas MCP server, pre-configured — read and write entries, pages, and media as agent tools.
• The atlas-cms skill — teaches the agent when to use the MCP tools, the @latellu/atlas-sdk delivery/management clients, or the @latellu/atlas-cli type generator, including the gotchas (caching, draft visibility, key scopes) it would otherwise trip over.

Installation (Claude Code)

claude plugin marketplace add tenriajeng/atlas-agent-skills
claude plugin install atlas@latellu

Configuration

The bundled MCP server reads your Atlas credentials from environment variables. Set them in the shell where you run claude (e.g. in ~/.zshrc):

export ATLAS_LIVE_API_KEY="atlas_live_xxx..."   # enables read tools
export ATLAS_MGMT_API_KEY="atlas_mgmt_xxx..."   # enables write tools
# optional:
export ATLAS_API_URL="https://api.atlas.latellu.com"          # only for self-hosted
export MCP_ALLOWED_UPLOAD_PATHS="/Users/you/Documents"        # restrict media uploads

Create keys at cms.atlas.latellu.com/dashboard/api-keys (sidebar: Developer → API Keys). At least one key must be set — the server won't start with neither. A single key unlocks only the matching half of the tools (atlas_live_* → read, atlas_mgmt_* → write); set both for the full set. See Authentication for scopes.

What you get

After installing and restarting Claude Code:

• MCP tools — get_workspace_schema, list_entries, get_entry, create_entry, update_entry, publish_entry, list_pages, get_page, create_page, publish_page, upload_media, and more. See the MCP Server reference for the full catalog.
• The atlas-cms skill — triggers automatically when your prompt involves Atlas content, the SDK, API keys, or type generation. It routes the agent to the right surface: SDK delivery client for frontends, CLI for typed interfaces, SDK management client for programmatic writes, MCP tools for conversational content operations.

Try prompts like:

List the content types in my Atlas workspace
Generate TypeScript types for my Atlas workspace into lib/atlas.types.ts
Create a draft news-article entry titled "Hello" and publish it
Add an Indonesian translation to that entry
Build a home page in Atlas with a hero block and a feature grid
Build a Next.js page that renders the "home" page from Atlas

Updating

claude plugin marketplace update latellu

Other AI agents (Cursor, Codex, opencode, Gemini CLI, ...)

The skill is plain markdown, so it is not Claude-specific. Install it into your project and point your agent at it:

npm install -D @latellu/atlas-agent-skills

Then add a pointer in your AGENTS.md (or Cursor rules) telling the agent to read node_modules/@latellu/atlas-agent-skills/skills/atlas-cms/SKILL.md for Atlas tasks, and register the MCP server (npx -y @latellu/atlas-mcp) in your agent's MCP configuration. Copy-paste snippets for each agent live in the repo: adapters/other-agents.md.

Without the plugin

You can still use each piece standalone: register the MCP server manually per the MCP Server guide, or use the SDK and CLI directly.