Skip to content
Back to search

supabase-agent-skills

MarketplaceWorks with Claude CodeGitHub

Agent Skills to help developers using AI agents with Supabase

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/supabase/agent-skills with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/supabase/agent-skills'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/supabase-agent-skills/badge.svg)](/listings/supabase-agent-skills)

HTML

<a href="/listings/supabase-agent-skills"><img src="/api/listings/supabase-agent-skills/badge.svg" alt="findsafeskills safety rating" /></a>

Install

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

See the [Supabase AI Skills documentation](https://supabase.com/docs/guides/getting-started/ai-skills) for detailed installation instructions.

Install all skills

npx skills add supabase/agent-skills

Install a specific skill

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

Claude Code Plugin

You can also install the skills as Claude Code plugins:

# 1. Install supabase/agent-skill marketplace
claude plugin marketplace add supabase/agent-skills

# 2. Install the plugin that you want 
claude plugin install supabase@supabase-agent-skills
claude plugin install postgres-best-practices@supabase-agent-skills

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

.claude-plugin/marketplace.json · Manifest · 27 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. {
  2. "name": "supabase-agent-skills",
  3. "owner": {
  4. "name": "Supabase",
  5. "email": "support@supabase.com"
  6. },
  7. "metadata": {
  8. "description": "Official Supabase agent skills for Claude Code",
  9. "version": "1.1.0"
  10. },
  11. "plugins": [
  12. {
  13. "name": "supabase",
  14. "description": "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, security audits, Postgres extensions (pg_graphql, pg_cron, pg_vector).",
  15. "source": "./",
  16. "strict": false,
  17. "skills": ["./skills/supabase"]
  18. },
  19. {
  20. "name": "postgres-best-practices",
  21. "description": "Postgres performance optimization and best practices. Use when writing, reviewing, or optimizing Postgres queries, schema designs, or database configurations.",
  22. "source": "./",
  23. "strict": false,
  24. "skills": ["./skills/supabase-postgres-best-practices"]
  25. }
  26. ]
  27. }
README.md · README · 141 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

  1. ![Supabase Agent Skills](assets/og.png)
  2. # Supabase Agent Skills
  3. Agent Skills to help developers using AI agents with Supabase. Agent Skills are
  4. folders of instructions, scripts, and resources that agents can discover and use
  5. to do things more accurately and efficiently. Compatible with 18+ AI agents
  6. including Claude Code, GitHub Copilot, Cursor, Cline, and many others.
  7. The skills in this repo follow the [Agent Skills](https://agentskills.io/)
  8. format.
  9. ## Installation
  10. See the [Supabase AI Skills documentation](https://supabase.com/docs/guides/getting-started/ai-skills)
  11. for detailed installation instructions.
  12. ### Install all skills
  13. ```bash
  14. npx skills add supabase/agent-skills
  15. ```
  16. ### Install a specific skill
  17. ```bash
  18. npx skills add supabase/agent-skills --skill supabase
  19. npx skills add supabase/agent-skills --skill supabase-postgres-best-practices
  20. ```
  21. ### Claude Code Plugin
  22. You can also install the skills as Claude Code plugins:
  23. ```bash
  24. # 1. Install supabase/agent-skill marketplace
  25. claude plugin marketplace add supabase/agent-skills
  26. # 2. Install the plugin that you want
  27. claude plugin install supabase@supabase-agent-skills
  28. claude plugin install postgres-best-practices@supabase-agent-skills
  29. ```
  30. ## Available Skills
  31. <details>
  32. <summary><strong>supabase</strong></summary>
  33. Comprehensive Supabase development skill covering all Supabase products and
  34. integrations.
  35. **Use when:**
  36. - Working with any Supabase product (Database, Auth, Edge Functions, Realtime,
  37. Storage, Vectors, Cron, Queues)
  38. - Using client libraries and SSR integrations (supabase-js, @supabase/ssr) in
  39. Next.js, React, SvelteKit, Astro, Remix
  40. - Troubleshooting auth issues (login, logout, sessions, JWT, cookies, getSession,
  41. getUser, getClaims, RLS)
  42. - Using the Supabase CLI or MCP server
  43. - Working with schema changes, migrations, security audits, or Postgres extensions
  44. (pg_graphql, pg_cron, pg_vector)
  45. </details>
  46. <details>
  47. <summary><strong>supabase-postgres-best-practices</strong></summary>
  48. Postgres performance optimization guidelines from Supabase. Contains references
  49. across 8 categories, prioritized by impact.
  50. **Use when:**
  51. - Writing SQL queries or designing schemas
  52. - Implementing indexes or query optimization
  53. - Reviewing database performance issues
  54. - Configuring connection pooling or scaling
  55. - Working with Row-Level Security (RLS)
  56. **Categories covered:**
  57. - Query Performance (Critical)
  58. - Connection Management (Critical)
  59. - Schema Design (High)
  60. - Concurrency & Locking (Medium-High)
  61. - Security & RLS (Critical)
  62. - Data Access Patterns (Medium)
  63. - Monitoring & Diagnostics (Low-Medium)
  64. - Advanced Features (Low)
  65. </details>
  66. ## Usage
  67. Skills are automatically available once installed. The agent will use them when
  68. relevant tasks are detected.
  69. **Examples:**
  70. ```
  71. Optimize this Postgres query
  72. ```
  73. ```
  74. Review my schema for performance issues
  75. ```
  76. ```
  77. Help me set up Supabase Auth with Next.js
  78. ```
  79. ```
  80. Help me add proper indexes to this table
  81. ```
  82. ## Skill Structure
  83. Each skill follows the [Agent Skills Open Standard](https://agentskills.io/):
  84. - `SKILL.md` - Required skill manifest with frontmatter (name, description, metadata)
  85. - `references/` - (Optional) Reference files for detailed documentation
  86. ## `.well-known` discovery
  87. Each release uploads a `dist/index.json` alongside the skill tarballs. This index conforms to the [agent-skills `.well-known` URI spec](https://github.com/agentskills/agentskills/pull/254) (schema v0.2.0) and is consumed by `supabase.com` to serve skills at `https://supabase.com/.well-known/agent-skills/`.
  88. The release artifacts are built by `scripts/build-release.ts` and triggered by [Release Please](https://github.com/googleapis/release-please) on every semver release.
  89. ### Migrating to the official GitHub Action
  90. [`jonathanhefner/agentskills-build-for-well-known`](https://github.com/jonathanhefner/agentskills-build-for-well-known) is intended to be transferred to the `agentskills` org and published to the GitHub Marketplace. When that happens, `scripts/build-release.ts` and the `pnpm build:release` step in `release-please.yml` can be replaced with the Action directly:
  91. ```yaml
  92. - name: Build release artifacts
  93. uses: agentskills/build-for-well-known@v1 # replaces pnpm build:release
  94. with:
  95. skills-dir: skills
  96. output-dir: dist
  97. ```
  98. Everything else — the Release Please trigger, the upload step, the supabase-plugin dispatch — stays exactly the same. The script and the Action produce identical output, so it is a drop-in swap.

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.