Communitygithub.com

Supabase Postgres Best Practices

Von Supabase gepflegte Best Practices für Postgres, die überall laufen. Lade dieses Skill BEVOR du Tabellen, Spalten, Schemas, RLS-Richtlinien, Indizes, Trigger oder Datenbankfunktionen erstellst oder änderst, oder wenn du langsame Abfragen, hohe CPU-Auslastung oder Sicherheitsprobleme diagnostizierst.

Was ist Supabase Postgres Best Practices?

Dieser Skill enthält eine umfassende Sammlung von Best Practices für Postgres, die von Supabase gepflegt und für den Einsatz überall optimiert sind. Er deckt acht priorisierte Kategorien ab: Abfrageperformance (kritisch), Verbindungsmanagement (kritisch), Sicherheit und Row-Level Security (kritisch), Schema-Design (hoch), Parallelität und Sperren (mittel-hoch), Datenzugriffsmuster (mittel), Überwachung und Diagnose (niedrig-mittel) sowie erweiterte Funktionen (niedrig). Jede Kategorie enthält detaillierte Regeldateien mit Erklärungen, falschen und korrekten SQL-Beispielen sowie optionalen EXPLAIN-Ausgaben. Der Skill ist besonders nützlich für Entwickler, die mit Supabase, Cursor, Claude Code, Codex oder ähnlichen KI-Agenten arbeiten, da er sicherstellt, dass Datenbankänderungen und Abfragen von Anfang an optimiert, sicher und korrekt sind. Er sollte vor jeglicher Schema-Änderung, Migration, RLS-Erstellung oder bei der Fehlersuche in der Datenbank geladen werden.

Funktioniert mit~Claude Code~Codex CLI~Cursor
npx skills add https://github.com/PhuongDeveloper/landingpage/tree/HEAD/.agents/skills/supabase-postgres-best-practices

In Ihrer bevorzugten KI fragen

Öffnet einen neuen Chat, in dem dieser Agent-Skill bereits geladen ist.

Dokumentation

Was macht Supabase Postgres Best Practices?

Umfassender Leitfaden zur Leistungsoptimierung für Postgres, gepflegt von Supabase. Enthält Regeln in 8 Kategorien, priorisiert nach Auswirkungen, um automatisierte Abfrageoptimierung und Schema-Design zu steuern.

Wann anwenden

Diese Richtlinien sollten herangezogen werden, wenn:

  • SQL-Abfragen geschrieben oder Schemas entworfen werden
  • Indizes implementiert oder Abfragen optimiert werden
  • Datenbankleistungsprobleme überprüft werden
  • Verbindungspooling oder Skalierung konfiguriert werden
  • Für Postgres-spezifische Funktionen optimiert wird
  • Mit Row-Level Security (RLS) gearbeitet wird

Regelkategorien nach Priorität

PrioritätKategorieAuswirkungPräfix
1AbfrageperformanceKRITISCHquery-
2VerbindungsmanagementKRITISCHconn-
3Sicherheit und RLSKRITISCHsecurity-
4Schema-DesignHOCHschema-
5Parallelität und SperrenMITTEL-HOCHlock-
6DatenzugriffsmusterMITTELdata-
7Überwachung und DiagnoseNIEDRIG-MITTELmonitor-
8Erweiterte FunktionenNIEDRIGadvanced-

Verwendung

Lies die einzelnen Regeldateien für detaillierte Erklärungen und SQL-Beispiele:

references/query-missing-indexes.md
references/query-partial-indexes.md
references/_sections.md

Jede Regeldatei enthält:

  • Kurze Erklärung, warum dies wichtig ist
  • Falsches SQL-Beispiel mit Erklärung
  • Richtiges SQL-Beispiel mit Erklärung
  • Optional EXPLAIN-Ausgabe oder Metriken
  • Zusätzlichen Kontext und Verweise
  • Supabase-spezifische Hinweise (falls zutreffend)

Referenzen

Individual skills in this repo

This repo contains 4 individual skills — each has its own dedicated page.

PhuongDeveloper/landingpage

Deploy applications and websites to Vercel. Use when the user requests deployment actions like "deploy my app", "deploy and give me the link", "push this live", or "create a preview deployment".

PhuongDeveloper/landingpage

Use when doing ANY task involving Supabase. Triggers: Supabase products (Database, Auth, Edge Functions, Realtime, Storage, Vectors, Cron, Queues); client libraries and SSR integrations (supabase-js, @supabase/ssr) in Next.js, React, SvelteKit, Astro, Remix; auth issues (login, logout, sessions, JWT, cookies, getSession, getUser, getClaims, RLS); Supabase CLI or MCP server; schema changes, migrations, declarative schemas, security audits, Postgres extensions (pg_graphql, pg_cron, pg_vector); debugging and troubleshooting errors or unexpected behavior on Supabase projects (HTTP errors, Postgres errors, RLS surprises, permission denied, schema cache issues, timeouts, Edge Function crashes, Realtime drops, Storage failures) and reading or querying logs (Logs Explorer, ClickHouse).

PhuongDeveloper/landingpage

Deploy and manage projects on Vercel using token-based authentication. Use when working with Vercel CLI using access tokens rather than interactive login — e.g. "deploy to vercel", "set up vercel", "add environment variables to vercel".

PhuongDeveloper/landingpage

React composition patterns that scale. Use when refactoring components with boolean prop proliferation, building flexible component libraries, or designing reusable APIs. Triggers on tasks involving compound components, render props, context providers, or component architecture. Includes React 19 API changes.

Verwandte Skills