mcpField
N
nocobase-utils

nocobase-utils

github.com/nocobaseDevelopment55288 installsUpdated 8w ago
Repository

About nocobase-utils

nocobase-utils is an agent skill providing authoritative references for utilities shared across NocoBase features. It is intended for tasks such as constructing filters, evaluating expressions, and generating UIDs, with filter guidance tied to live field types.

Key features

  1. 01Topic-organized utility references
  2. 02Filter formats and operator guidance
  3. 03Expression engines and functions
  4. 04Bundled UID generation script

Use cases

  1. 01Build filters for NocoBase fields
  2. 02Look up expression engines and functions
  3. 03Generate short UIDs for UI schemas

Install

Copy the command and run it in a terminal.

$npx skills add https://github.com/nocobase/skills --skill nocobase-utils

After installing, type/nocobase-utilsin Claude Code to confirm it loaded.

Bundled files

References and scripts installed along with SKILL.md.

references/evaluators/
formulajs.md
index.md
mathjs.md
references/filter/
index.md
references/uid/
index.md
scripts/
uid.js

Details

From the project README

Goal

Provide accurate, authoritative reference information for NocoBase cross-cutting utilities. Content is organized by topic and will grow over time.

When to Use

Invoke this skill (or its sub-references) when you need authoritative reference material that applies across multiple NocoBase features, such as:

  • Constructing any persisted or UI-displayable NocoBase filter condition, especially when choosing an operator from natural-language intent
  • Expression evaluation engines and available functions
  • Generating short opaque UIDs for UI schemas or other configuration payloads
  • Other shared utilities (to be added)

For filter authoring, invoke this skill with topic filter; reading the Filter reference is a hard prerequisite, not optional background material. Before emitting an operator, resolve the terminal field's live interface/type and select the operator from that field group's allowlist. Do not translate words such as “before”, “less than”, “at least”, or “not later than” directly into a generic comparison operator from model knowledge.

Bundled Scripts

  • Reuse scripts/uid.js when a UI or schema payload needs a short random UID and there is no existing project helper already in use.
  • The script supports both patterns: import uid() into target code, or resolve the script path in the current workspace and run node <resolved-path-to-uid.js> 16 to print a UID during agent work.

Reference Index

TopicFile
Filter condition format — structure, operators, variablesreferences/filter/index.md
Evaluator engines — overview, engine selection, critical rulesreferences/evaluators/index.md
formula.js complete function referencereferences/evaluators/formulajs.md
math.js complete function referencereferences/evaluators/mathjs.md
UID generation — when to use, guardrails, usage examplesreferences/uid/index.md

Comments

Markdown supported