ObjectOS
Construire

Skills IDE (Claude Code / Cursor / Copilot)

Installez les skills ObjectOS dans votre agent de codage afin que Claude Code, Cursor, Copilot, Codex et compagnie sachent rédiger correctement les métadonnées ObjectOS.

Skills IDE

L'AI Builder vit dans Console et communique avec la base de données de votre tenant. Mais il arrive que vous vouliez les mêmes connaissances métier directement dans votre IDE — lorsque vous éditez à la main des *.object.ts, concevez un flow ou demandez à Cursor d'écrire un prédicat CEL.

ObjectOS fournit 9 agent skills first-party qui apprennent aux assistants de codage à rédiger tous les types de métadonnées ObjectOS. Ils sont distribués via l'écosystème ouvert skills (Vercel Labs) et fonctionnent avec Claude Code, Cursor, Copilot, Codex, Gemini CLI, Windsurf, Cline, Continue, Roo, Goose, Kiro, opencode et une cinquantaine d'autres agents.

Installation

Dans n'importe quel projet utilisant les packages @objectstack/* :

npx skills add objectstack-ai/framework

La CLI détecte les agents que vous avez configurés (.claude/, .cursor/, .github/copilot/, AGENTS.md, etc.) et écrit les skills au bon endroit. Relancez-la à tout moment pour récupérer les dernières versions.

Aucune modification de package.json, aucune installation globale. Les skills sont de simples fichiers markdown commités dans votre dépôt afin que toute l'équipe — ainsi que les agents de CI — partagent les mêmes instructions.

Ce que vous obtenez

SkillÀ charger quand vous travaillez sur…
objectstack-platformdefineStack, drivers, adaptateurs, plugins, services, la CLI os, le déploiement
objectstack-data*.object.ts, *.seed.ts, champs, relations, validations, index, hooks de cycle de vie, RLS
objectstack-queryObjectQL — filtres, tri, pagination, agrégation, jointures, fonctions de fenêtrage, recherche plein texte
objectstack-uiViews, Apps, Pages, Dashboards, Reports, Charts, Actions
objectstack-automationFlows, Workflows, Triggers, Approvals, planifications, webhooks
objectstack-aiAgents, Tools, Skills, Conversations, Model Registry, MCP
objectstack-apiendpoints REST/GraphQL, authentification, temps réel, enveloppes d'erreur
objectstack-i18nbundles de traduction, repli de locale, couverture
objectstack-formulaexpressions CEL — champs de formule, prédicats de validation/partage/visibilité, conditions

Chaque skill est conscient de son périmètre — il indique à l'agent quand se charger lui-même et quand déléguer à un skill voisin, afin que Claude n'essaie pas de modéliser un objet avec le skill platform ni d'écrire une expression CEL avec le skill data.

Comment ça fonctionne

Chaque skill est un dossier sous skills/ dans le dépôt framework :

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

Le frontmatter du SKILL.md est ce que skills add lit pour router le skill vers la bonne surface d'agent :

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

Une règle fondamentale dans tous les skills : les schémas Zod de @objectstack/spec font foi. Les skills donnent l'intention ; les agents lisent les schémas dans node_modules/@objectstack/spec/src/**/*.zod.ts pour connaître la forme exacte des champs. C'est pourquoi les champs hallucinés disparaissent de fait une fois les skills installés.

Skills vs. AI Builder

AI BuilderSkills IDE
Où ça s'exécuteConsole (navigateur)Votre IDE / agent de codage
Ce que ça modifieMétadonnées en direct dans votre tenantFichiers de votre dépôt
Agit pour le compte deVos utilisateurs finaux / adminsVos développeurs
Modèle d'approbationFile HITL (ai:approve)Revue de pull request
Idéal pourExtensions du quotidien, utilisateurs no-codeTemplates, packages, flows complexes, code de bibliothèque

Les deux sont complémentaires. La plupart des équipes utilisent l'AI Builder pour la personnalisation du tenant et les skills IDE lorsqu'elles travaillent sur des packages qu'elles comptent publier (voir Templates et Marketplace).

Mise à jour

Les skills suivent les versions de @objectstack/spec. Relancez npx skills add objectstack-ai/framework après avoir mis à niveau le package spec pour garder votre agent synchronisé avec les derniers schémas Zod, helpers CEL et vocabulaire de métadonnées.

Voir aussi

  • AI Builder — l'équivalent intégré à Console
  • Agents — déclarez des agents côté serveur qui s'exécutent à l'intérieur d'ObjectOS
  • Templates — chaque template officiel est conçu avec ces skills chargés

On this page