nocobase-data-modeling

Inspect and mutate NocoBase collections, fields, and relations via the nb api data-modeling CLI.

45|10|Updated Mar 2, 2026
One-click install
npx skills add https://github.com/nocobase/skills --skill nocobase-data-modeling
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: nocobase-data-modeling
Source: https://github.com/nocobase/skills/tree/main/skills/nocobase-data-modeling
Command: npx skills add https://github.com/nocobase/skills --skill nocobase-data-modeling

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill includes references (resource) components.

What problem does it solve?

This skill provides a structured, safe way to model and evolve NocoBase data schemas, reducing drift between intended models and deployed metadata.

Core Features & Use Cases

  • Inspect and reflect current collections and fields to understand the existing schema.
  • Create and update ordinary and special collections (general, tree, file, calendar, sql, view, and inherit) with basic business fields and required relations.
  • Verify mutations using the provided verification playbook and ensure alignment with the intended model.

Quick Start

Install the data-modeling skill and run a minimal update by inspecting a collection and adding a simple field.

Frequently Asked Questions about nocobase-data-modeling

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I create and configure collections in NocoBase?

To create collections in NocoBase, you inspect existing schemas and mutate metadata to add general, tree, file, calendar, sql, view, or inherit collections with basic business fields and required relations.

Can I update an existing NocoBase data schema without causing drift?

Yes, you can update a NocoBase data schema safely by executing mutations through the data-modeling CLI with strict pre-checks for transport reachability and authentication, followed by post-mutation verification.

Does NocoBase support file and calendar collections for data modeling?

NocoBase data modeling supports creating and updating special collections including file, calendar, tree, sql, view, and inherit collections, alongside ordinary general collections and their related fields.

Why do my NocoBase collection mutations fail during plugin gating checks?

NocoBase collection mutations fail during plugin gating when strict pre-checks detect issues with transport reachability, authentication, or plugin capability gates, preventing unsafe metadata changes.

What is NocoBase data modeling used for?

NocoBase data modeling is used to identify, configure, and evolve data schemas by inspecting and mutating collections, fields, and relations, reducing drift between intended models and deployed metadata.