- name
- nocobase-app-plugin-development
- description
- Create and maintain NocoBase 3 plugins inside an existing App or a NocoBase 3 source workspace, including Client, Server, CLI, database resources, UI Library integration, Plugin Skills, and registration. Use for App-local plugins under packages/ and source-workspace plugins or examples. Not for creating an App, application-only feature work, or legacy NocoBase 2 plugins.
NocoBase Plugin Development
Use this Skill to develop a plugin in the user’s existing NocoBase 3 App. Read that App’s AGENTS.md, relevant installed Skills, and the plugin before editing. An App created by create-app identifies itself with nocobase.templateKind: "app" in package.json; its local plugins belong in packages/. Start from an installed App with working dependencies. If no App exists, use the available nocobase-create-app Skill first, then return here. Do not download the NocoBase source repository as a prerequisite.
This Skill ships with the App's installed @nocobase/app-skills; update it through a compatible App upgrade and pnpm nocobase skills sync, not by editing the generated copy or installing a global copy. Read it by its project path when an older global entry has the same name. The upgrade Skill describes retiring that global installation after a project replacement is verified.
For work explicitly in the NocoBase source repository, the repository links this same maintained Skill locally. Read .agents/rules/plugin-development.md from that repository root for source-only creation, registration and validation commands. An App does not need those repository files. Source paths in references are optional lookup locations; use installed exports, declarations and synchronized Skills to verify APIs for the App's version. Do not apply the legacy Plugin class, src/client-v2/ or nb scaffold plugin protocol. If the creation tool or App CLI lacks App-workspace support, report the incompatible packages instead of hand-building a scaffold or downloading the source repository.
Choose the relevant references
These English references adapt the plugin development guide into task-specific instructions. Read the rows relevant to the task; do not load the entire reference set by default.