Agent Skills
Noma Agent Skills are knowledge packs for AI coding assistants. They teach consistent patterns for @nomacms/js-sdk, the Content API, project user authentication, error handling, and framework-specific integration—so the model does not have to infer everything from generic documentation on each task.
Skills are installed with the skills CLI (npx skills add …). The repository is organized as one directory per skill, each with a SKILL.md file (and optional reference.md / examples.md).
Skills included
The repository ships 13 skills:
| Skill | What it covers |
|---|---|
| noma-sdk-setup | createClient, env vars, tokens, TokenStorageAdapter, project locales (REST + admin key) |
| noma-content | Content CRUD, filtering, pagination, bulk operations; singleton vs list list() response shapes |
| noma-assets | Asset upload, metadata, bulk operations |
| noma-user-auth | Sign up/in (password and social id_token), refresh, auth state, user API keys |
| noma-auth-contract | Canonical frontend auth contract and integration checklist |
| noma-nextjs-auth | Next.js–specific auth guardrails |
| noma-auth-review | Auditing existing auth code against the Noma auth contract |
| noma-collections-fields | Collection and field schema management |
| noma-mcp-content-structure | Schema-first workflows with Noma MCP (collections and fields before UI; works with Next.js, Nuxt, Astro, or other SDK apps) |
| noma-errors | Error hierarchy and try/catch patterns |
| noma-nextjs | Next.js integration (RSC, SSG/ISR, server actions) |
| noma-nuxt | Nuxt integration (server routes, Pinia, Nitro) |
| noma-astro | Astro integration (static, SSR, content layer) |
How skills relate to MCP
| Piece | Role |
|---|---|
| MCP server | Performs CMS operations in your project (collections, entries, assets, and so on) |
| Agent skills | Teaches how to write and structure application code that uses the SDK and auth correctly |
| JavaScript SDK | What actually runs in your app at runtime |
Install both when you want the agent to manage the CMS and ship idiomatic frontend or backend code.
Picking skills
Start minimal and add what your stack needs:
- Most projects:
noma-sdk-setup,noma-errors - Content-heavy apps: add
noma-content - Heavy media: add
noma-assets - End-user accounts in your app: add
noma-user-auth; addnoma-auth-contract,noma-nextjs-auth(or equivalents), andnoma-auth-reviewwhen you need strict contract checks - Schema work: add
noma-collections-fields - AI + MCP in the editor: add
noma-mcp-content-structureso the agent builds schema-first, not only static placeholder pages - Framework: one of
noma-nextjs,noma-nuxt,noma-astro
See Installation for CLI commands and options.
Related
- Installation -
npx skills addexamples and flags - AI Code Editors - End-to-end setup with MCP and the SDK
- MCP Server - Tools and resources for CMS automation
- JavaScript SDK - Client configuration and methods