Install
npx skills add supabase/agent-skills누구에게 맞나
이 가이드는 이미 또는 곧 AI Agent로 Supabase 개발을 하려는 사람을 위한 것이다. 공식 문장은 개발자가 AI agents에서 Supabase를 쓰도록 돕는 Agent Skills로 적혀 있다.
시작 전에 이 기기에서 npx를 실행할 수 있는지, 그리고 현재 디렉터리가 스킬 파일을 쓸 프로젝트인지 확인하라. 페이지는 18+ AI agents와 호환된다고 명시하며, Claude Code, GitHub Copilot, Cursor, Cline 및 그 외 다수를 포함한다. 이는 호환 설명이지 배타 목록이 아니며, 제품 목록에서 언어 범위를 역산해서도 안 된다.
설치 후 스킬은 자동으로 사용 가능하며, Agent는 관련 작업을 감지하면 사용한다. 첫 시도에서는 데이터베이스를 바꾸거나, 함수를 게시하거나, 스토리지를 바꾸는 작업을 일부러 트리거하지 마라.
3분 안에 첫 시도 완료하기
페이지가 제시한 권장 설치 명령만 사용한다.
npx skills add supabase/agent-skills
전제 조건: 이 기기에 npx가 있고, 현재 작업 디렉터리가 대상 프로젝트 루트다. 설치 위치는 현재 프로젝트다. 해당 페이지에 나오지 않은 마켓 명령이나 수동 복사 경로로 바꾸어 쓰지 마라.
부작용 확인 지점: 이 명령은 스킬 파일을 현재 프로젝트에 쓴다. 디렉터리가 틀리면 먼저 멈춰라. 설치 자체는 Supabase 프로젝트를 자동으로 바꾸지 않는다. 다만 이후 Agent가 관련 작업을 감지하면 이 스킬을 사용할 수 있다. 디렉터리가 맞는지 확인한 뒤에 실행하라.
성공 신호: 명령이 정상 종료되고 프로젝트에 스킬 파일이 나타난다. 이어서 확인은 한 번만 한다. 호환 Agent에서 읽기 전용 질문을 하고, 예를 들어 현재 Database 또는 Auth 연결을 어떻게 이해해야 하는지 물어, 설치된 스킬에 따라 답하는지 보라. 테이블 생성, Edge Functions 배포, Storage 변경, Cron/Queues 조작은 하지 마라. Agent가 쓰기를 실행하려 하면 확인 지점에서 멈춰라.
사용 사례
사례 1: 공식 스킬을 현재 프로젝트에 설치한다. 확인한 프로젝트 루트에서 npx skills add supabase/agent-skills를 실행한다. 근거가 다루는 것은 이 명령과, 개발자가 AI agents로 Supabase를 쓰도록 돕는다는 점이다. 완료 기준은 설치 성공과 스킬 파일 출현까지다. 나타나지 않은 업데이트나 제거 명령을 보태지 마라.
사례 2: 설치 후 읽기 전용 제품 확인을 한다. 페이지는 스킬이 어떤 Supabase 제품이든 다룬다고 명시한다: Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues. 또한 설치 후 자동으로 사용 가능하며, Agent는 관련 작업을 감지하면 사용한다. 발췌에는 구체적인 슬래시 명령이 없으므로, 첫 번째는 그중 한 제품에 대한 읽기 전용 설명만 묻는다. 예를 들어 기존 Database 또는 Auth 설정을 어떻게 이해해야 하는지다. 관찰 가능한 성공 신호는 Agent가 설치된 스킬에 따라 분명히 답하는 것이지, 이미 클라우드 자원을 바꿨다는 것이 아니다. Cron, Queues, Storage 같은 쓰기 면은 제품 목록에 있지만, 첫 시도에서 조작해야 한다는 뜻은 아니다.
사용 경계
주 설치 경로는 npx skills add supabase/agent-skills뿐이다. 나열된 Agent는 유일한 지원 범위가 아니다. 관련 작업이 감지되면 스킬이 자동으로 켜지므로, 온라인 데이터를 바꾸는 작업은 질문에서 피하라. 제품 목록은 인가 목록이 아니다. 제거, 구체적인 스킬 파일 이름, 제품별 명령은 발췌에 없으며, 적히지 않은 내용을 안전 결론으로 삼을 수 없다.