Integration guide · Last reviewed April 2026
Noma agent skills
Markdown skill packs teach agents how to use @nomacms/js-sdk idiomatically, avoid auth footguns, and align framework code with Noma’s APIs. Install them with the skills CLI alongside MCP for the best results.
Open source on GitHub
All skills live in nomacms/nomacms-agent-skills. Each package includes SKILL.md with YAML front matter plus optional reference.md and examples.md files.
skills CLI quick start
List everything available:
npx skills add nomacms/nomacms-agent-skills --list
Install a tailored bundle:
npx skills add nomacms/nomacms-agent-skills --skill noma-sdk-setup --skill noma-content
Pass -a cursor (or another host) to limit installers, and -g when you truly need a global copy—project-local installs are the default.
Skills included
| Skill | Focus |
|---|---|
| noma-sdk-setup | Client bootstrap, tokens, env, locales |
| noma-content | CRUD, filters, singleton vs list responses |
| noma-assets | Uploads, metadata, bulk asset operations |
| noma-user-auth | Sign-in flows, refresh, user API keys |
| noma-auth-contract | Canonical frontend auth checklist |
| noma-nextjs-auth | Next.js / NextAuth guardrails |
| noma-auth-review | Audit existing auth implementations |
| noma-collections-fields | Schema management deep dive |
| noma-mcp-content-structure | Schema-first sites with MCP + any framework |
| noma-errors | Error types and handling patterns |
| noma-nextjs | RSC, caching, server actions |
| noma-nuxt | Server routes, Pinia, Nitro |
| noma-astro | Static, SSR, content layer |
MCP + skills
MCP excels at live operations against your project (schema inspection, entry edits, uploads). Skills excel at teaching the agent patterns, error handling, and framework-specific file layout. Pair noma-mcp-content-structure with MCP when you want schema-first workflows without static placeholder sections.
Need the server details? Jump to Noma MCP server or the per-agent guides: Cursor, Claude Code, Codex.
Start building with Noma
Create a free account, spin up a project, and ship structured content with our API, SDK, and AI tools.