ObjectOSIDE Skills (Claude Code / Cursor / Copilot)
코딩 에이전트에 ObjectOS skills를 설치하여 Claude Code, Cursor, Copilot, Codex 등이 ObjectOS 메타데이터를 올바르게 작성하는 방법을 알도록 하세요.
IDE Skills
AI Builder는 Console 안에서 동작하며 테넌트의
데이터베이스와 통신합니다. 하지만 때로는 동일한 도메인 지식을 IDE
안에서 사용하고 싶을 때가 있습니다 — *.object.ts를 직접 편집하거나,
플로우를 설계하거나, Cursor에게 CEL 술어를 작성하라고 요청할 때처럼요.
ObjectOS는 코딩 어시스턴트에게 모든 종류의 ObjectOS 메타데이터를
작성하는 방법을 가르치는 9개의 퍼스트파티 에이전트 skills를
제공합니다. 이 skills는 오픈 skills
생태계(Vercel Labs)를 통해 배포되며 Claude Code, Cursor, Copilot,
Codex, Gemini CLI, Windsurf, Cline, Continue, Roo, Goose, Kiro,
opencode 및 그 외 약 50개의 에이전트와 함께 작동합니다.
설치
@objectstack/* 패키지를 사용하는 모든 프로젝트에서:
npx skills add objectstack-ai/frameworkCLI는 어떤 에이전트가 구성되어 있는지(.claude/,
.cursor/, .github/copilot/, AGENTS.md 등) 감지하고 skills를
적절한 위치에 작성합니다. 최신 버전을 가져오려면 언제든지 다시
실행하세요.
package.json변경도, 전역 설치도 없습니다. Skills는 리포지토리에 커밋되는 일반 마크다운 파일이므로 팀 전체와 CI 에이전트가 동일한 지침을 공유합니다.
무엇을 얻나요
| Skill | 작업 대상이… 일 때 로드 |
|---|---|
objectstack-platform | defineStack, 드라이버, 어댑터, 플러그인, 서비스, os CLI, 배포 |
objectstack-data | *.object.ts, *.seed.ts, 필드, 관계, 검증, 인덱스, 라이프사이클 훅, RLS |
objectstack-query | ObjectQL — 필터, 정렬, 페이지네이션, 집계, 조인, 윈도우 함수, 전문 검색 |
objectstack-ui | Views, Apps, Pages, Dashboards, Reports, Charts, Actions |
objectstack-automation | Flows, Workflows, Triggers, Approvals, 스케줄, 웹훅 |
objectstack-ai | Agents, Tools, Skills, Conversations, Model Registry, MCP |
objectstack-api | REST/GraphQL 엔드포인트, 인증, 실시간, 에러 엔벨로프 |
objectstack-i18n | 번역 번들, 로케일 폴백, 커버리지 |
objectstack-formula | CEL 표현식 — 수식 필드, 검증/공유/가시성 술어, 조건 |
각 skill은 스코프를 인식합니다 — 언제 자신을 로드하고 언제 형제 skill에게 위임할지 에이전트에게 알려주므로, Claude가 platform skill로 객체를 모델링하거나 data skill로 CEL 표현식을 작성하려고 시도하지 않습니다.
작동 방식
모든 skill은
framework repo의
skills/ 아래에 있는 폴더입니다:
skills/objectstack-data/
├── SKILL.md # YAML frontmatter + prose guide
├── references/
│ └── _index.md # pointers into @objectstack/spec Zod sources
└── rules/ # optional deep-dive rulesSKILL.md frontmatter는 skills add가 읽어서 skill을 적절한
에이전트 표면으로 라우팅하는 내용입니다:
---
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
---모든 skill에 걸친 핵심 규칙: @objectstack/spec의 Zod 스키마가
진실입니다. Skills는 의도를 제공하고, 에이전트는 정확한 필드 형태를
위해 node_modules/@objectstack/spec/src/**/*.zod.ts의 스키마를
읽습니다. 이것이 바로 skills를 설치하면 환각으로 만들어진 필드가
사실상 사라지는 이유입니다.
Skills vs. AI Builder
| AI Builder | IDE Skills | |
|---|---|---|
| 실행 위치 | Console (브라우저) | 당신의 IDE / 코딩 에이전트 |
| 변경 대상 | 테넌트의 라이브 메타데이터 | 리포지토리의 파일 |
| 대행 대상 | 최종 사용자 / 관리자 | 개발자 |
| 승인 모델 | HITL 큐 (ai:approve) | 풀 리퀘스트 리뷰 |
| 적합한 용도 | 일상적인 확장, 노코드 사용자 | 템플릿, 패키지, 복잡한 플로우, 라이브러리 코드 |
이 둘은 상호 보완적입니다. 대부분의 팀은 테넌트 커스터마이징에는 AI Builder를, 그리고 게시할 의도가 있는 패키지 작업에는 IDE skills를 사용합니다(자세한 내용은 Templates 및 Marketplace 참조).
업데이트
Skills는 @objectstack/spec 버전을 따릅니다. spec 패키지를 업그레이드한
후 npx skills add objectstack-ai/framework를 다시 실행하여 에이전트를
최신 Zod 스키마, CEL 헬퍼, 메타데이터 어휘와 동기화 상태로 유지하세요.
관련 항목
- AI Builder — Console 내의 대응 기능
- Agents — ObjectOS 내부에서 실행되는 서버 측 에이전트 선언
- Templates — 모든 공식 템플릿은 이 skills를 로드한 상태로 구축됩니다