ObjectOSIDE Skills (Claude Code / Cursor / Copilot)
Install ObjectOS skills into your coding agent so Claude Code, Cursor, Copilot, Codex and friends know how to author ObjectOS metadata correctly.
IDE Skills
The AI Builder lives inside Console and talks to your
tenant's database. But sometimes you want the same domain knowledge
inside your IDE — when you're hand-editing *.object.ts, designing a
flow, or asking Cursor to write a CEL predicate.
ObjectOS ships 9 first-party agent skills that teach coding
assistants how to author every kind of ObjectOS metadata. They are
distributed through the open skills
ecosystem (Vercel Labs) and work with Claude Code, Cursor, Copilot,
Codex, Gemini CLI, Windsurf, Cline, Continue, Roo, Goose, Kiro,
opencode and ~50 other agents.
Install
In any project that uses @objectstack/* packages:
npx skills add objectstack-ai/frameworkThe CLI detects which agents you have configured (.claude/,
.cursor/, .github/copilot/, AGENTS.md, etc.) and writes the
skills to the right place. Re-run any time to pull the latest
versions.
No
package.jsonchange, no global install. Skills are plain markdown files committed to your repo so the whole team — and CI agents — share the same instructions.
What you get
| Skill | Load when you're working on… |
|---|---|
objectstack-platform | defineStack, drivers, adapters, plugins, services, the os CLI, deployment |
objectstack-data | *.object.ts, *.seed.ts, fields, relationships, validations, indexes, lifecycle hooks, RLS |
objectstack-query | ObjectQL — filters, sorting, pagination, aggregation, joins, window functions, full-text search |
objectstack-ui | Views, Apps, Pages, Dashboards, Reports, Charts, Actions |
objectstack-automation | Flows, Workflows, Triggers, Approvals, schedules, webhooks |
objectstack-ai | Agents, Tools, Skills, Conversations, Model Registry, MCP |
objectstack-api | REST/GraphQL endpoints, auth, realtime, error envelopes |
objectstack-i18n | Translation bundles, locale fallback, coverage |
objectstack-formula | CEL expressions — formula fields, validation/sharing/visibility predicates, conditions |
Each skill is scope-aware — it tells the agent when to load itself and when to defer to a sibling skill, so Claude doesn't try to model an object with the platform skill or write a CEL expression with the data skill.
How it works
Every skill is a folder under skills/ in the
framework repo:
skills/objectstack-data/
├── SKILL.md # YAML frontmatter + prose guide
├── references/
│ └── _index.md # pointers into @objectstack/spec Zod sources
└── rules/ # optional deep-dive rulesThe SKILL.md frontmatter is what skills add reads to route the
skill to the right agent surface:
---
name: objectstack-data
description: Design ObjectStack data schemas — objects, fields, ...
license: Apache-2.0
compatibility: Requires @objectstack/spec Zod schemas (v4+)
metadata:
domain: data
tags: object, field, validation, relationship, hook, permission, rls
---A core rule across all skills: the Zod schemas in
@objectstack/spec are the truth. Skills give intent; agents read
the schemas in node_modules/@objectstack/spec/src/**/*.zod.ts for
exact field shapes. This is why hallucinated fields effectively
disappear once the skills are installed.
Skills vs. AI Builder
| AI Builder | IDE Skills | |
|---|---|---|
| Where it runs | Console (browser) | Your IDE / coding agent |
| What it changes | Live metadata in your tenant | Files in your repo |
| Acts on behalf of | Your end users / admins | Your developers |
| Approval model | HITL queue (ai:approve) | Pull request review |
| Best for | Day-to-day extensions, no-code users | Templates, packages, complex flows, library code |
The two are complementary. Most teams use the AI Builder for tenant customisation and IDE skills when working on packages they intend to publish (see Templates and Marketplace).
Updating
The skills follow @objectstack/spec versions. Re-run
npx skills add objectstack-ai/framework after upgrading the spec
package to keep your agent in sync with the latest Zod schemas, CEL
helpers, and metadata vocabulary.
Related
- AI Builder — the in-Console counterpart
- Agents — declare server-side agents that run inside ObjectOS
- Templates — every official template is built with these skills loaded