From 5c9d145adf9e10806c8daeb58998f7e405fabe0d Mon Sep 17 00:00:00 2001 From: Pedro Rodrigues Date: Wed, 21 Jan 2026 16:10:36 +0000 Subject: [PATCH] first review --- AGENTS.md | 2 +- README.md | 7 ++++--- skills/postgres-best-practices/AGENTS.md | 2 +- skills/postgres-best-practices/README.md | 19 +++++-------------- skills/postgres-best-practices/metadata.json | 2 +- 5 files changed, 12 insertions(+), 20 deletions(-) diff --git a/AGENTS.md b/AGENTS.md index a4e0348..a15b55d 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -5,7 +5,7 @@ etc.) when working with code in this repository. ## Repository Overview -A collection of Postgres best practices skills for Claude.ai and Claude Code, +A collection of Postgres best practices skills for AI coding agents, maintained by Supabase. Skills are packaged instructions that extend agent capabilities for database optimization. diff --git a/README.md b/README.md index 21238f5..1e38085 100644 --- a/README.md +++ b/README.md @@ -1,8 +1,9 @@ # Supabase Agent Skills -Battle-tested database expertise from Supabase, packaged as AI agent skills. -These skills provide AI coding agents with proven patterns for building and -optimizing production Postgres applications. +Agents skills to help you develope with Supabase. These skills provide AI coding +agents like Claude Code, Cursor, Github Copilot, etc... with specialized +instructions for building and optimizing production Postgres and Supabase +applications. Skills follow the [Agent Skills](https://agentskills.io/) format. diff --git a/skills/postgres-best-practices/AGENTS.md b/skills/postgres-best-practices/AGENTS.md index fe9cf48..1c60891 100644 --- a/skills/postgres-best-practices/AGENTS.md +++ b/skills/postgres-best-practices/AGENTS.md @@ -10,7 +10,7 @@ January 2026 ## Abstract -Comprehensive PostgreSQL performance optimization guide for developers using Supabase and PostgreSQL. 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. +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. --- diff --git a/skills/postgres-best-practices/README.md b/skills/postgres-best-practices/README.md index 78bb454..ed33ee9 100644 --- a/skills/postgres-best-practices/README.md +++ b/skills/postgres-best-practices/README.md @@ -1,6 +1,7 @@ # Postgres Best Practices - Contributor Guide -This repository contains Postgres performance optimization rules optimized for AI agents and LLMs. +This repository contains Postgres performance optimization rules optimized for +AI agents and LLMs. ## Quick Start @@ -67,7 +68,7 @@ packages/postgres-best-practices-build/ See `rules/_template.md` for the complete template. Key elements: -```markdown +````markdown --- title: Clear, Action-Oriented Title impact: CRITICAL|HIGH|MEDIUM-HIGH|MEDIUM|LOW-MEDIUM|LOW @@ -85,6 +86,7 @@ tags: relevant, keywords -- Comment explaining what's wrong [Bad SQL example] ``` +```` **Correct (description):** @@ -93,11 +95,7 @@ tags: relevant, keywords [Good SQL example] ``` -**Supabase Note:** [Optional platform-specific guidance] - -Reference: [Link](url) ``` - ## Writing Guidelines See `rules/_contributing.md` for detailed guidelines. Key principles: @@ -118,11 +116,4 @@ See `rules/_contributing.md` for detailed guidelines. Key principles: | MEDIUM | 1.5-3x | Redundant indexes, stale statistics | | LOW-MEDIUM | 1.2-2x | VACUUM tuning, config tweaks | | LOW | Incremental | Advanced patterns, edge cases | - -## Supabase-Specific Content - -Keep ~90% of content as universal Postgres patterns. Add Supabase notes for: -- Supavisor connection pooling -- Dashboard features (index monitoring, query stats) -- RLS best practices with Supabase auth -- PostgREST considerations +``` diff --git a/skills/postgres-best-practices/metadata.json b/skills/postgres-best-practices/metadata.json index 725a8fb..c82546a 100644 --- a/skills/postgres-best-practices/metadata.json +++ b/skills/postgres-best-practices/metadata.json @@ -2,7 +2,7 @@ "version": "1.0.0", "organization": "Supabase", "date": "January 2026", - "abstract": "Comprehensive Postgre performance optimization guide for developers using Supabase and Postgre. 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.", + "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.", "references": [ "https://www.postgresql.org/docs/current/", "https://supabase.com/docs",