Install
npx skills add clerk/skills누구에게 맞나
코딩 Agent로 Clerk 인증을 더 수월하게 다루고 싶을 때, 특히 새 프로젝트나 임의의 프레임워크에 Clerk를 넣거나, 사용자·조직·앱·환경 키·배포를 점검할 때 이 스킬 세트를 쓴다. 스킬은 Agent Skills 형식을 따르며, 코드베이스에 Clerk를 붙이되 Agent가 먼저 올바른 스킬을 고른 뒤 손대기를 원하는 개발자를 향한다. 공식은 /clerk를 라우터로 표시하고 항상 여기서 시작하라고 적는다. 처음부터 하위 스킬을 지명하지 말 것. 시작 전에 Clerk Dashboard를 열고 환경 파일에 쓸 수 있는 키를 받을 수 있어야 한다. 그렇지 않으면 이후 연동과 점검은 키 부족에서 멈춘다.
3분 만에 첫 시도 끝내기
공식 저장소가 준 설치 명령만 따른다:
npx skills add clerk/skills
설치 후에는 먼저 키를 준비한다. 자리 표시자로 숫자를 맞추지 말 것. Clerk Dashboard를 열고 게시 가능 키와 비밀 키를 복사해 프로젝트 .env에 쓴다. 키 이름은 반드시 NEXT_PUBLIC_CLERK_PUBLISHABLE_KEY와 CLERK_SECRET_KEY다. 쓰기 전에 Agent가 이 두 키 이름과 대상 파일만 되말하게 하고, 확인한 뒤에만 파일 변경을 허용한다.
첫 작업은 되돌릴 수 있는 점검을 고르고 프레임워크를 바꾸지 않는다. 스킬이 이미 로드된 클라이언트에서 /clerk를 입력하고, 배포 점검 또는 환경 키 대조를 원한다고 말해 라우터가 clerk-cli로 데려가게 한다. 어떤 명령이든 실행하기 전에, 호출할 것은 CLI 점검이며 사용자를 새로 만들거나 조직을 바꾸지 않는다고 Agent에게 말하게 한다. 확인한 뒤에만 실행한다.
성공 신호: Agent가 /clerk에서 clerk-cli로 들어가 환경 키 또는 배포 점검 결과를 반환하고, 스킬 없음이나 키 없음을 내지 않는다. Codex를 쓰는 경우 공식에는 별도 마켓 추가 명령이 있다. 추가 후 재시작하고 /plugins를 연 뒤 Clerk Skills를 선택하고 clerk-skills를 설치·활성화한 다음 새 스레드를 연다. 이는 Codex 전용 단계이며 기본 설치로 보지 말 것.
사용 사례
사례 1: 새 프로젝트 또는 임의 프레임워크 연동. 공식 스킬 clerk-setup의 역할은 임의 프레임워크에 Clerk를 더하는 것이며, 새 프로젝트와 프레임워크 초기화에 맞다. 방법은 먼저 /clerk, 현재 프레임워크와 “Clerk 연동만 추가”라고 말한 뒤 라우터가 clerk-setup에 닿게 한다. 이런 작업은 프로젝트 파일을 바꾸므로, Agent가 바꿀 파일을 나열하게 한 뒤 확인한 다음에 쓴다. 설명에는 구체 프레임워크 목록이나 단계별 패치가 없다. 프레임워크 세부사항은 설치 후 스킬 설명을 따른다.
사례 2: CLI로 읽기 전용 운영 점검. clerk-cli는 사용자, 조직, 앱, 환경 키, 배포 점검을 다룬다. 키를 .env에 쓴 뒤 기존 앱이 배포 가능한지, 키가 갖춰졌는지, 또는 사용자와 조직을 읽기 전용으로 볼 때 맞다. 마찬가지로 먼저 /clerk 다음 clerk-cli. 설명은 구체 CLI 하위 명령을 나열하지 않으므로 명령 이름을 만들지 말 것. 확인할 수 있는 것은 위 점검 범주이며, 출력 형식은 실제 실행을 따른다.
사용 경계
Dashboard 키가 없으면 연동을 시작하지 말 것. 환경 파일은 공식이 적은 두 키 이름만 쓰고, 기록되지 않은 변수로 바꾸지 말 것. 기본 설치는 npx skills add clerk/skills다. Codex 마켓 설치는 Codex에만 해당하며 공식 순서로 clerk-skills를 활성화해야 한다. 항상 /clerk에서 시작한다. 페이지는 다른 입구를 라우터를 건너뛸 수 있다고 쓰지 않았다. 공식은 전체 클라이언트 명단을 내지 않았다. Codex 예에서 독점 지원을 추론하지 말고, 페이지 예에서 언어 범위도 추론하지 말 것. 적혀 있지 않은 스킬 디렉터리, 마켓 명령, 키 예시는 채우지 말 것. 저장소 페이지:
https://github.com/clerk/skills
Dashboard:
https://dashboard.clerk.com/