DocsDevelopersClaude Code

Claude Code

The RootCX skill teaches your AI coding agent how to write internal tools and AI agents that deploy to the Core. It works with Claude Code, Codex, Cursor, or any AI coding agent that supports skills.

Install the skill

npx skills add rootcx/skills

That is the only setup. The skill loads into your AI coding agent's context automatically when you describe what you want to build. See Getting Started for the full setup flow (CLI install, project creation, deploy).

The 6 skills

Skills are knowledge modules. They activate contextually based on what you are building.

Skill What it teaches
rootcx-manifest manifest.json: entity definitions, field types, relationships, permission keys, webhooks, crons, actions, public access, schema sync behavior.
rootcx-sdk-hooks @rootcx/sdk: useAppCollection, useAppRecord, usePermissions, useCrons, useIntegration, useIdentity, useCoreCollection, useRuntimeClient, and the full where-clause DSL.
rootcx-ui Frontend UI: AppShell layout, AuthGate, DataTable, Forms, dialogs, toasts, dark mode, Tailwind CSS v4 conventions.
rootcx-backend-worker Backend logic: serve() API, RPC handlers with caller context, onJob hook, collection operations via IPC, direct PostgreSQL access, lifecycle hooks, 30-second RPC timeout.
rootcx-rest-api Core HTTP API: collections CRUD, bulk operations, POST /query with operators, integration actions, job queue, Bearer token auth.
rootcx-agent AI agents: agent.json configuration, system prompts, built-in tools (query_data, mutate_data, invoke_agent), supervision modes, approval flows, SSE streaming.

Skills path resolution

The CLI finds skills in this order:

  1. ROOTCX_SKILLS_DIR environment variable (if set).
  2. Relative to the rootcx binary (../.agents/skills/).
  3. ~/.rootcx/skills/ (fallback).

What gets generated

Your AI coding agent produces standard RootCX code:

my_app/
├── manifest.json         # Data model + permissions
├── backend/
│   └── index.ts          # serve() with RPC handlers
└── src/
    └── App.tsx           # React + @rootcx/sdk

Deploy with rootcx deploy. The code is identical to what you would write by hand. You can switch between AI coding agents at any point.

PreviousCLINextSelf-Hosting