SKILL.md
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](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
| Topic |
File |
| Filter condition format — structure, operators, variables |
[references/filter/index.md](references/filter/index.md) |
| Evaluator engines — overview, engine selection, critical rules |
[references/evaluators/index.md](references/evaluators/index.md) |
| formula.js complete function reference |
[references/evaluators/formulajs.md](references/evaluators/formulajs.md) |
| math.js complete function reference |
[references/evaluators/mathjs.md](references/evaluators/mathjs.md) |
| UID generation — when to use, guardrails, usage examples |
[references/uid/index.md](references/uid/index.md) |