Przejdź do treści
Biblioteka skilli
Dane i analityka · Przegląd i audyt

supabase-postgres-best-practices

/supabase-postgres-best-practices

Podpowiada dobre praktyki Postgresa z Supabase przy schematach, zapytaniach, indeksach, politykach RLS i migracjach na dowolnym hostingu.

Licencja
MIT
Ostatnia zmiana repozytorium
27.10.2026

Ocena i bezpieczeństwo

100/ 100Klasa: dobry
Format25 / 25
Frontmatter z nazwą i opisem, poprawna nazwa, opis do 1024 znaków, nazwa zgodna z folderem.
Odkrywalność25 / 25
Opis mówi, kiedy użyć skilla, ma sensowną długość i jest w 3. osobie.
Treść35 / 35
Co najmniej 150 słów i do 500 linii, nagłówki, listy kroków, przykłady albo kod.
Higiena15 / 15
Bez zaślepek typu TODO, bez ścieżek Windows, z licencją.
Ryzykobrak sygnałów w skanie
Pliki w paczce
36
Skrypty
0
Komentarze HTML
2
Adresy URL w SKILL.md
6
Przestarzałość

Brak sygnałów. Repozytorium zmienione 27.10.2026, bez odwołań do wycofanych modeli i API.

Licencja

MIT, otwarta: można używać i zmieniać, z zachowaniem informacji o autorze.

Co sprawdzić przed instalacją
  • SKILL.md zawiera komentarze HTML (2). Nie widać ich w podglądzie Markdown, a model je czyta.

Co robi i kiedy

Podpowiada dobre praktyki Postgresa z Supabase przy schematach, zapytaniach, indeksach, politykach RLS i migracjach na dowolnym hostingu.

Oryginalny opis (EN)

Use when writing or reviewing Postgres schemas, queries, indexes, RLS policies, connection settings, or migrations with Supabase guidance; applicable to Postgres on any hosting platform.

Jak działa

  1. When to Apply
  2. Rule Categories by Priority
  3. How to Use
  4. References
  5. Review Workflow
  6. Acceptance Evidence
  7. Boundaries
Sekcje z nagłówków SKILL.md, w oryginale · 95 linii, 541 słów
Podgląd SKILL.md
---
name: supabase-postgres-best-practices
description: 'Use when writing or reviewing Postgres schemas, queries, indexes, RLS policies, connection settings, or migrations with Supabase guidance; applicable to Postgres on any hosting platform.'
zh_description: "用于编写或评审 Supabase/Postgres 的查询、Schema、索引、RLS、连接配置与迁移。"
version: "1.0.4"
author: "seaworld008"
source: "github:supabase/agent-skills"
source_url: "https://skills.sh/supabase/agent-skills/supabase-postgres-best-practices"
license: MIT
tags: '["best", "development", "postgres", "supabase"]'
created_at: "2026-05-05"
updated_at: "2026-09-07"
quality: 3
complexity: "intermediate"
metadata:
  author: supabase
  version: "1.1.1"
  organization: Supabase
  date: January 2026
  abstract: Comprehensive Postgres performance optimization guide for developers using Supabase and Postgres. Contains performance rules across 8 categories, prioritized by impact from critical (query performance, connection management) to incremental (advanced features). Each rule includes detailed explanations, incorrect vs. correct SQL examples, query plan analysis, and specific performance metrics to guide automated optimization and code generation.
---

# Supabase Postgres Best Practices

Comprehensive performance optimization guide for Postgres, maintained by Supabase. Contains rules across 8 categories, prioritized by impact to guide automated query optimization and schema design.

## When to Apply

Reference these guidelines when:
- Writing SQL queries or designing schemas
- Implementing indexes or query optimization
- Reviewing database performance issues
- Configuring connection pooling or scaling
- Optimizing for Postgres-specific features
- Working with Row-Level Security (RLS)

## Rule Categories by Priority

| Priority | Category | Impact | Prefix |
|----------|----------|--------|--------|
| 1 | Query Performance | CRITICAL | `query-` |
| 2 | Connection Management | CRITICAL | `conn-` |
| 3 | Security & RLS | CRITICAL | `security-` |
| 4 | Schema Design | HIGH | `schema-` |
| 5 | Concurrency & Locking | MEDIUM-HIGH | `lock-` |
| 6 | Data Access Patterns | MEDIUM | `data-` |
| 7 | Monitoring & Diagnostics | LOW-MEDIUM | `monitor-` |
| 8 | Advanced Features | LOW | `advanced-` |

## How to Use

Read individual rule files for detailed explanations and SQL examples:

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

Each rule file contains:
- Brief explanation of why it matters
- Incorrect SQL example with explanation
- Correct SQL example with explanation
- Optional EXPLAIN output or metrics
- Additional context and references
- Supabase-specific notes (when applicable)

## References

- https://www.postgresql.org/docs/current/
- https://supabase.com/docs
- https://wiki.postgresql.org/wiki/Performance_Optimization
- https://supabase.com/docs/guides/database/overview
- https://supabase.com/docs/guides/auth/row-level-security
<!-- LOCAL-QUALITY-SUPPLEMENT:START -->
## Review Workflow

Select only the rule files that match the task. Start with correctness and
access control, then measure performance before proposing tuning changes.

1. Identify the database version, hosting constraints, workload shape, and
   whether the task changes data or only reviews SQL.
2. Read the relevant `query-`, `conn-`, `security-`, `schema-`, `lock-`,
   `data-`, or `monitor-` references; avoid loading the full rule set by default.
3. Preserve existing RLS and privilege boundaries. Treat disabling RLS,
   broadening grants, destructive DDL, and production writes as separate,
   explicitly authorized actions.
4. For performance claims, capture the query shape and an `EXPLAIN` or
   `EXPLAIN (ANALYZE, BUFFERS)` result in a safe environment. Do not infer an
   improvement from the presence of an index alone.
5. Verify migrations on a representative schema, including rollback or a
   forward-fix path, lock duration, and compatibility with concurrent traffic.

## Acceptance Evidence

- Query tuning: compare plans and measured latency or buffer usage under the
  same parameters and representative data distribution.
- Index changes: confirm intended scans use the index and account for write,
  storage, and maintenance overhead.
- RLS or privilege changes: test allowed and denied paths with the actual roles;
  service-role success is not proof that end-user policies work.
- Connection changes: verify pool mode, transaction semantics, prepared
  statement compatibility, connection limits, and saturation behavior.
- Schema changes: verify constraints, backfill behavior, lock exposure, and the
  recovery procedure before production rollout.

## Boundaries

- Never run `EXPLAIN ANALYZE` on a mutating statement in production without an
  explicitly safe transaction and authorization; plain `EXPLAIN` is the safer
  default for uncertain statements.
- Do not present generic PostgreSQL advice as a Supabase platform guarantee.
- Static SQL review and local tests do not prove production capacity, failover,
  replication health, or zero-downtime migration behavior.
<!-- LOCAL-QUALITY-SUPPLEMENT:END -->
Pliki w paczce (36)
  • CHANGELOG.md 6 KB
  • SKILL.md 5 KB
  • references/_contributing.md 4 KB
  • references/_sections.md 2 KB
  • references/_template.md 1 KB
  • references/advanced-full-text-search.md 1 KB
  • references/advanced-jsonb-indexing.md 1 KB
  • references/conn-idle-timeout.md 1 KB
  • references/conn-limits.md 1 KB
  • references/conn-pooling.md 1 KB
  • references/conn-prepared-statements.md 1 KB
  • references/data-batch-inserts.md 1 KB
  • references/data-n-plus-one.md 1 KB
  • references/data-pagination.md 1 KB
  • references/data-upsert.md 1 KB
  • references/lock-advisory.md 1 KB
  • references/lock-deadlock-prevention.md 2 KB
  • references/lock-short-transactions.md 1 KB
  • references/lock-skip-locked.md 1 KB
  • references/monitor-explain-analyze.md 1 KB
  • references/monitor-pg-stat-statements.md 1 KB
  • references/monitor-vacuum-analyze.md 1 KB
  • references/query-composite-indexes.md 1 KB
  • references/query-covering-indexes.md 1 KB
  • references/query-index-types.md 1 KB
  • references/query-missing-indexes.md 1 KB
  • references/query-partial-indexes.md 1 KB
  • references/schema-constraints.md 2 KB
  • references/schema-data-types.md 1 KB
  • references/schema-foreign-key-indexes.md 2 KB
  • references/schema-lowercase-identifiers.md 2 KB
  • references/schema-partitioning.md 2 KB
  • references/schema-primary-keys.md 2 KB
  • references/security-privileges.md 2 KB
  • references/security-rls-basics.md 1 KB
  • references/security-rls-performance.md 2 KB

Wersje

RepozytoriumWynikLicencja
Ta strona · seaworld008/commonly-used-high-value-skills100MIT
FrancoStino/opencode-skills-collection100MIT
davila7/claude-code-templates100MIT
sickn33/agentic-awesome-skills100MIT
openai/plugins100MIT
fancyboi999/loomic100MIT
elophanto/EloPhanto95MIT

Identyczna treść występuje jeszcze w 2 innych folderach na GitHubie. Tu pokazujemy jedną, najlepiej ocenioną kopię.

Migawka bazy z 13.11.2026 · wersja paczki 4befcc8aebc5 (skrót SHA-256 całej paczki)

Pobrania w ostatnich 30 dniach: 0 · ranking

Zgłoś problem z tym skillem: szkodliwa treść, błędny opis albo prośba autora o usunięcie.

Podobne skille

  • 100postgres-best-practices
    Stosuje dobre praktyki wydajności Postgres od Supabase przy pisaniu, przeglądzie i optymalizacji zapytań, projektów schematów i konfiguracji bazy.
  • 100postgres-best-practices
    Stosuje dobre praktyki wydajności Postgres od Supabase przy pisaniu, przeglądzie i optymalizacji zapytań, projektów schematów i konfiguracji bazy.
  • 100postgres-best-practices
    Stosuje dobre praktyki wydajności Postgres od Supabase przy pisaniu, przeglądzie i optymalizacji zapytań, projektów schematów i konfiguracji bazy.
  • 100postgres-patterns
    Podpowiada wzorce optymalizacji zapytań, projektowania schematów, indeksowania i bezpieczeństwa PostgreSQL, zgodne z dobrymi praktykami Supabase.
  • 100postgres-best-practices
    Optymalizuje zapytania, schematy i konfigurację Postgresa według dobrych praktyk Supabase przy pisaniu i przeglądzie kodu bazodanowego.
  • 100postgres-patterns
    Podpowiada wzorce PostgreSQL dla zapytań, schematów, indeksów i bezpieczeństwa, gdy trzeba zaprojektować RLS lub poprawić wolne zapytanie.

Uwagi i zgłoszenia

Wiadomość trafi do Bartosza Sokolińskiego. Adres e-mail jest potrzebny tylko do odpowiedzi. Szczegóły w polityce prywatności.