Installieren Sie ObjectOS-Skills in Ihren Coding-Agent, damit Claude Code, Cursor, Copilot, Codex und Co. wissen, wie man ObjectOS-Metadaten korrekt erstellt.

IDE-Skills

Der AI Builder lebt innerhalb der Console und kommuniziert mit der Datenbank Ihres Mandanten. Aber manchmal möchten Sie dasselbe Domänenwissen direkt in Ihrer IDE — wenn Sie *.object.ts von Hand bearbeiten, einen Flow entwerfen oder Cursor bitten, ein CEL-Prädikat zu schreiben.

ObjectOS liefert 9 First-Party-Agent-Skills mit, die Coding-Assistenten beibringen, wie man jede Art von ObjectOS-Metadaten erstellt. Sie werden über das offene skills-Ökosystem (Vercel Labs) verteilt und funktionieren mit Claude Code, Cursor, Copilot, Codex, Gemini CLI, Windsurf, Cline, Continue, Roo, Goose, Kiro, opencode und etwa 50 weiteren Agents.

Installation

In jedem Projekt, das @objectstack/*-Pakete verwendet:

npx skills add objectstack-ai/framework

Die CLI erkennt, welche Agents Sie konfiguriert haben (.claude/, .cursor/, .github/copilot/, AGENTS.md usw.) und schreibt die Skills an die richtige Stelle. Führen Sie den Befehl jederzeit erneut aus, um die neuesten Versionen zu beziehen.

Keine Änderung an package.json, keine globale Installation. Skills sind reine Markdown-Dateien, die in Ihr Repository committet werden, sodass das gesamte Team — und CI-Agents — dieselben Anweisungen teilen.

Was Sie erhalten

Skill	Laden, wenn Sie an … arbeiten
`objectstack-platform`	`defineStack`, Drivern, Adaptern, Plugins, Services, der `os`-CLI, Deployment
`objectstack-data`	`.object.ts`, `.seed.ts`, Feldern, Beziehungen, Validierungen, Indizes, Lifecycle-Hooks, RLS
`objectstack-query`	ObjectQL — Filter, Sortierung, Pagination, Aggregation, Joins, Window-Funktionen, Volltextsuche
`objectstack-ui`	Views, Apps, Pages, Dashboards, Reports, Charts, Actions
`objectstack-automation`	Flows, Workflows, Triggers, Approvals, Zeitplänen, Webhooks
`objectstack-ai`	Agents, Tools, Skills, Conversations, Model Registry, MCP
`objectstack-api`	REST/GraphQL-Endpunkten, Auth, Realtime, Error-Envelopes
`objectstack-i18n`	Übersetzungs-Bundles, Locale-Fallback, Abdeckung
`objectstack-formula`	CEL-Ausdrücken — Formelfeldern, Validierungs-/Sharing-/Sichtbarkeits-Prädikaten, Bedingungen

Jeder Skill ist scope-aware — er teilt dem Agent mit, wann er sich selbst laden und wann er an einen verwandten Skill verweisen soll, sodass Claude nicht versucht, ein Objekt mit dem Platform-Skill zu modellieren oder einen CEL-Ausdruck mit dem Data-Skill zu schreiben.

Wie es funktioniert

Jeder Skill ist ein Ordner unter skills/ im Framework-Repo:

skills/objectstack-data/
├── SKILL.md              # YAML frontmatter + prose guide
├── references/
│   └── _index.md         # pointers into @objectstack/spec Zod sources
└── rules/                # optional deep-dive rules

Das Frontmatter in SKILL.md ist das, was skills add liest, um den Skill an die richtige Agent-Oberfläche zu leiten:

---
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
---

Eine zentrale Regel über alle Skills hinweg: Die Zod-Schemas in @objectstack/spec sind die Wahrheit. Skills vermitteln die Absicht; Agents lesen die Schemas in node_modules/@objectstack/spec/src/**/*.zod.ts für die exakten Feldformen. Deshalb verschwinden halluzinierte Felder praktisch, sobald die Skills installiert sind.

Skills vs. AI Builder

	AI Builder	IDE-Skills
Wo es läuft	Console (Browser)	Ihre IDE / Ihr Coding-Agent
Was es ändert	Live-Metadaten in Ihrem Mandanten	Dateien in Ihrem Repository
Handelt im Namen von	Ihren Endnutzern / Admins	Ihren Entwicklern
Genehmigungsmodell	HITL-Warteschlange (`ai:approve`)	Pull-Request-Review
Am besten für	Tägliche Erweiterungen, No-Code-Nutzer	Templates, Pakete, komplexe Flows, Bibliothekscode

Die beiden ergänzen sich. Die meisten Teams nutzen den AI Builder für die Mandantenanpassung und IDE-Skills bei der Arbeit an Paketen, die sie veröffentlichen wollen (siehe Templates und Marketplace).

Aktualisieren

Die Skills folgen den @objectstack/spec-Versionen. Führen Sie npx skills add objectstack-ai/framework nach dem Upgrade des Spec-Pakets erneut aus, um Ihren Agent mit den neuesten Zod-Schemas, CEL-Helfern und dem Metadaten-Vokabular synchron zu halten.

Verwandt

AI Builder — das Gegenstück innerhalb der Console
Agents — deklarieren Sie serverseitige Agents, die innerhalb von ObjectOS laufen
Templates — jedes offizielle Template wird mit diesen geladenen Skills erstellt

IDE-Skills (Claude Code / Cursor / Copilot)