Supabase에서 공식적으로 관리하는 Postgres 규칙 라이브러리입니다. 에이전트가 SQL을 작성하거나, 테이블 생성 및 컬럼 수정, 마이그레이션 작성, RLS 정책 설정, 인덱스 추가를 하거나, 느린 쿼리, 연결 고갈, 락 및 테이블 팽창을 디버깅할 때 먼저 이 라이브러리를 로드하세요. 영향도에 따라 8가지 범주로 규칙이 분류되며, 각 규칙에는 잘못된 SQL과 올바른 SQL의 비교 예시가 제공됩니다.
skills.sh 설치 횟수 468744 (+1162 / 24시간)
보안 감사: 감사되지 않음
- 아직 스캔되지 않음
이유
- 8가지 범주는 우선순위에 따라 정렬됩니다. 쿼리 성능, 연결 관리, 보안 및 RLS는 CRITICAL로 분류되며, 그 다음으로 테이블 구조 설계, 동시성 및 락, 데이터 접근 패턴, 모니터링 및 진단, 고급 기능이 옵니다. 규칙 파일은 references/ 디렉터리에 query-, conn-, security- 등의 접두사로 저장됩니다
- 트리거 범위가 매우 넓게 설정되어 있습니다. 단 하나의 컬럼을 수정하거나 쿼리 하나를 작성하더라도 로드가 요구되며, pg_cron, pgmq 큐, pgvector 벡터 검색 및 pg_restore 가져오기도 포함됩니다
- 각 규칙에는 이유, 잘못된 SQL 및 올바른 SQL 예시, 선택적 EXPLAIN 출력, 필요 시 Supabase 전용 설명이 포함됩니다. 저자는 Supabase에 국한되지 않으며 어디서 실행되는 Postgres든 사용할 수 있다고 주장합니다
- MIT 라이선스, 버전 1.1.1; skills.sh에서 24시간 동안 설치 횟수 1162, 누적 468744 (이는 단지 관심도를 나타냄)
사용법
- 설치 명령어는 감사 통과 후 표시됩니다. README에는 Claude Code 플러그인 방식도 제시되어 있습니다: claude plugin marketplace add supabase/agent-skills를 실행한 후, claude plugin install postgres-best-practices@supabase-agent-skills를 실행하세요
- Supabase 계정이나 다른 서비스가 필요하지 않습니다. 이는 순수 텍스트 규칙이며, 에이전트가 필요 시 references/ 디렉터리의 개별 규칙 파일을 읽습니다
리스크
- 이번 주에는 감사되지 않았으므로 고정 C 등급이며 설치 명령어가 표시되지 않습니다. SKILL.md에는 텍스트와 참조 링크만 있고 스크립트나 네트워크 요청은 없습니다. skills.sh에서 세 곳의 제3자 감사 모두 Pass로 평가되었습니다
- 이번에는 SKILL.md의 전체 표만 읽었으며, references/ 디렉터리의 구체적인 규칙은 항목별로 읽지 않았습니다. 트리거 범위가 넓어 Postgres를 건드리면 모두 로드되므로 컨텍스트를 차지합니다
- 규칙은 Supabase에서 나왔으므로 일부 제안 사항(연결 풀, RLS 작성 방식)은 Supabase 플랫폼의 관례를 따릅니다. 자체 구축한 Postgres 환경에서는 직접 판단해야 합니다