AI Skills para IDE

El AI Builder vive dentro de Console y se comunica con la base de datos de tu tenant. Pero a veces quieres ese mismo conocimiento de dominio dentro de tu IDE — cuando editas a mano *.object.ts, diseñas un flow o le pides a Cursor que escriba un predicado CEL.

ObjectOS incluye 9 AI Skills de agente de primera categoría que enseñan a los asistentes de programación cómo crear todo tipo de metadatos de ObjectOS. Se distribuyen a través del ecosistema abierto skills (Vercel Labs) y funcionan con Claude Code, Cursor, Copilot, Codex, Gemini CLI, Windsurf, Cline, Continue, Roo, Goose, Kiro, opencode y ~50 agentes más.

Instalación

En cualquier proyecto que use paquetes @objectstack/*:

npx skills add objectstack-ai/framework

El CLI detecta qué agentes tienes configurados (.claude/, .cursor/, .github/copilot/, AGENTS.md, etc.) y escribe las skills en el lugar correcto. Vuelve a ejecutarlo en cualquier momento para obtener las últimas versiones.

No hay cambios en package.json ni instalación global. Las skills son simples archivos markdown incluidos en tu repositorio, de modo que todo el equipo — y los agentes de CI — comparten las mismas instrucciones.

Qué obtienes

Cada skill conoce su alcance — le indica al agente cuándo cargarse y cuándo delegar en una skill hermana, de modo que Claude no intente modelar un objeto con la skill de plataforma ni escribir una expresión CEL con la skill de datos.

Cómo funciona

Cada skill es una carpeta dentro de skills/ en el repositorio del framework:

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

El frontmatter de SKILL.md es lo que lee skills add para enrutar la skill a la superficie de agente correcta:

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

Una regla fundamental en todas las skills: los esquemas Zod en @objectstack/spec son la fuente de verdad. Las skills aportan la intención; los agentes leen los esquemas en node_modules/@objectstack/spec/src/**/*.zod.ts para conocer las formas exactas de los campos. Por eso los campos alucinados desaparecen efectivamente una vez instaladas las skills.

Skills frente a AI Builder

Ambos son complementarios. La mayoría de los equipos usan el AI Builder para la personalización del tenant y las AI Skills para IDE al trabajar en paquetes que pretenden publicar (consulta Templates y Marketplace).

Actualización

Las skills siguen las versiones de @objectstack/spec. Vuelve a ejecutar npx skills add objectstack-ai/framework tras actualizar el paquete spec para mantener tu agente sincronizado con los últimos esquemas Zod, helpers de CEL y vocabulario de metadatos.

Relacionado

• AI Builder — la contraparte dentro de Console
• Agents — declara agentes del lado del servidor que se ejecutan dentro de ObjectOS
• Templates — cada plantilla oficial se construye con estas skills cargadas