Skill audit report

supabase-postgres-best-practices Audit report.

Postgres best practices maintained by Supabase, for Postgres running anywhere. Load this skill BEFORE writing or changing anything that lives in a Postgres database: creating or altering tables and columns (including choosing column types), schema design, migrations and declarative schema files, RLS policies and the tests that verify them, indexes, triggers, database functions, queues and scheduled jobs (pg_cron, pgmq), vector/semantic search (pgvector), and restoring dumps (pg_restore) or importing data. Also load it when diagnosing slow queries, high CPU, timeouts, EXPLAIN plans, connection exhaustion, locking, bloat, or rows visible to the wrong user or tenant. This is not just a performance guide — schema, migration, security, and SQL authoring tasks need these rules too, even for a one-column change or a single query.

EXPERIMENTAL · REVIEWNeeds reviewGenerated Nov 4, 2026Heuristic metadata audit
78
Audit
70
Trust
78
Quality
76
Security
88
Maintain
92
Install

OpenAgentSkill Trust Score

70
Manual review

OpenAgentSkill Trust Score

The Trust Score helps an agent decide whether a skill is safe enough to shortlist before installation.

GitHub adoption

PASS

86

2.6K GitHub stars

Stars/forks activity

INFO

77

2.6K stars, 200 forks; issue activity unavailable in current metadata

Recent maintenance

PASS

88

3mo since push

License clarity

PASS

86

MIT

README/SKILL.md completeness

PASS

86

Metadata includes enough usage and workflow context

Dependency/runtime risk

INFO

64

credential or environment access, database surface

Install availability

PASS

92

npx skills add supabase/agent-skills --skill supabase-postgres-best-practices

Install command safety

PASS

92

standard package or runtime install path

Permission surface

WARN

48

secrets or environment access, filesystem or document access

Repository evidence

PASS

86

https://github.com/supabase/agent-skills/tree/main/skills/supabase-postgres-best-practices

Review status

INFO

66

AI review data available

Agent Proven outcomes

INFO

54

No agent outcome data yet

Checks

Install and adoption review

7 Passed · 11 Needs review

Install path

92

PASS

npx skills add supabase/agent-skills --skill supabase-postgres-best-practices

Repository

88

PASS

https://github.com/supabase/agent-skills/tree/main/skills/supabase-postgres-best-practices

License

86

PASS

MIT

Maintenance

88

PASS

3mo since push

AI review

55

CHECK

SKILL.md metadata version is 1.1.1 but the changelog shows the latest release is 1.6.0, creating a version mismatch.

README/SKILL.md completeness

86

PASS

Usable description available

Dependency risk

64

CHECK

credential or environment access, database surface

Install command safety

92

PASS

standard package or runtime install path

Permission surface

48

FIX

secrets or environment access, filesystem or document access

Stars/forks activity

77

CHECK

2.6K stars, 200 forks; issue activity unavailable in current metadata

Adoption

88

PASS

2.6K GitHub stars

Warnings

  • Permission surface may require sandboxing
  • SKILL.md metadata version is 1.1.1 but the changelog shows the latest release is 1.6.0, creating a version mismatch.
  • SKILL.md does not include an explicit 'Safety and Limitations' section advising agents to avoid executing DDL or migrations without human review in production environments.
  • The SKILL.md reference list is very short and does not enumerate the full set of rule files available in the skill, which makes discoverability weaker.
  • Quality score needs review
  • Permission surface needs review: secrets or environment access, filesystem or document access
  • Permission surface: secrets or environment access, filesystem or document access

Method

This report combines public metadata, AI review output, repository freshness, install readiness, OpenAgentSkill events, quality scoring, trust checks, and the agent safety gate. It is not a full source-code security review.

Compare nearby options

Related skills to audit next