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/frameworkLa 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-platform | defineStack, 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-query | ObjectQL — filtres, tri, pagination, agrégation, jointures, fonctions de fenêtrage, recherche plein texte |
objectstack-ui | Views, Apps, Pages, Dashboards, Reports, Charts, Actions |
objectstack-automation | Flows, Workflows, Triggers, Approvals, planifications, webhooks |
objectstack-ai | Agents, Tools, Skills, Conversations, Model Registry, MCP |
objectstack-api | endpoints REST/GraphQL, authentification, temps réel, enveloppes d'erreur |
objectstack-i18n | bundles de traduction, repli de locale, couverture |
objectstack-formula | expressions 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 rulesLe 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 Builder | Skills IDE | |
|---|---|---|
| Où ça s'exécute | Console (navigateur) | Votre IDE / agent de codage |
| Ce que ça modifie | Métadonnées en direct dans votre tenant | Fichiers de votre dépôt |
| Agit pour le compte de | Vos utilisateurs finaux / admins | Vos développeurs |
| Modèle d'approbation | File HITL (ai:approve) | Revue de pull request |
| Idéal pour | Extensions du quotidien, utilisateurs no-code | Templates, 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