Convex 컴포넌트 작성 가이드

무엇을 해주나

• Convex 컴포넌트의 표준 디렉터리 구조(src/index.ts, component.ts, schema.ts, functions/)를 잡아 줍니다.
• defineComponent, defineSchema, query/mutation 정의를 검증기(v.*)와 반환 타입까지 포함한 예시 코드로 제시합니다.
• 소비하는 앱에서 defineApp().use()로 컴포넌트를 연결하고, 여러 인스턴스를 이름으로 구분하는 방법을 안내합니다.
• npm 배포용 package.json(peerDependencies, files, prepublishOnly)과 tsconfig.json 템플릿을 제공합니다.
• 테이블 격리, 타입 export, 시맨틱 버저닝 등 흔한 실수 5가지를 정리해 줍니다.
• 안전장치로 npx convex deploy나 git 명령을 임의로 실행하지 않도록 지시합니다.

이런 분께 추천

• Convex 백엔드를 쓰면서 여러 프로젝트에 공통 기능을 재사용하고 싶은 개발자
• 사내 공용 Convex 패키지나 오픈소스 컴포넌트를 npm에 배포하려는 팀
• Convex의 컴포넌트 격리 모델(테이블 분리)을 처음 익히는 TypeScript 개발자

활용 예시

1. "요청 제한(rate limiter) 컴포넌트를 만들어줘" → 스킬 내 예시처럼 requests 테이블과 checkLimit 뮤테이션, 소비 측 훅까지 생성.
2. "기존 convex 폴더의 알림 기능을 별도 컴포넌트 패키지로 분리해줘" → 스키마·함수 이동, index.ts export, package.json 작성까지 진행.
3. "이 컴포넌트를 앱 두 곳에 다른 이름으로 붙여줘" → app.use(myComponent, { name: "instance1" }) 패턴 적용.

이 파일의 지시를 읽고 그대로 따라서 나를 도와줘:
https://raw.githubusercontent.com/waynesutton/convexskills/HEAD/skills/convex-component-authoring/SKILL.md

내가 원하는 것: (여기에 하고 싶은 일을 쓰세요)

클로드스킬마트에서 찾은 스킬을 설치해줘.
GitHub 저장소 waynesutton/convexskills 의 skills/convex-component-authoring 폴더를 내 ~/.claude/skills/convex-component-authoring/ 에 그대로 복사해줘.
설치가 끝나면 이 스킬로 무엇을 할 수 있는지 한 줄로 알려줘.