Supabase Debug

Use when diagnosing Supabase issues like RLS, auth, empty queries, webhooks, and performance problems in production apps.

41 stars 1 forksDatabases

Install

skills CLI (Claude Code, Cursor, Codex and more)
npx skills add wolverin0/claude-skills --skill supabase-debug
Manual install
git clone --depth 1 https://github.com/wolverin0/claude-skills.git /tmp/claude-skills
mkdir -p ~/.claude/skills
cp -r /tmp/claude-skills/skills/supabase-debug ~/.claude/skills/supabase-debug

Personal skills live in ~/.claude/skills. Use .claude/skills in a project folder to share a skill with your team.

From the SKILL.md

# Supabase Debugging Patterns

Quick-reference debugging skill for Supabase-backed projects (9/11 active projects use Supabase).

## Common Issues & Fixes

### Empty Data / Missing Records
```
Symptom: Query returns empty array but data exists in DB
```
1. **Check RLS policies** - most common cause
   ```sql
   -- View policies on a table
   SELECT * FROM pg_policies WHERE tablename = 'your_table';
   ```
2. **Check auth state** - is user authenticated-
   ```typescript
   const { data: { user } } = await supabase.auth.getUser();
   console.log('Auth state:', user?.id, user?.role);
   ```
3. **Check tenant filtering** - multi-tenant apps filter by `company_id`
   ```typescript
   // Verify the company_id matches
   const { data } = await supabase.from('table').select('*').eq('company_id', companyId);
   ```

### Auth Issues
```
Symptom: 401 Unauthorized, session expired, login loops
```
1. Check if token is expired: `supabase.auth.getSession()`
2. Verify redirect URLs in Supabase dashboard match app URL
3. For OAuth: check provider settings in Supabase Auth config
4. Clear local storage and re-authenticate

### RPC / Edge Function Failures
```
Symptom: Function call returns error or unexpected result
```
1. Check Supabase dashboard -> Edge Functions -> Logs
2. Verify function exists and is deployed: `supabase functions list`
3. Check function has correct permissions (auth required vs public)
4. Test directly: `curl -X POST <supabase_url>/functions/v1/<function_name>`
Read the full skill on GitHub

Details

Skill name
supabase-debug
Path
skills/supabase-debug/SKILL.md
Repo updated
17 November 2026

FAQ

What does the Supabase Debug skill do?

Use when diagnosing Supabase issues like RLS, auth, empty queries, webhooks, and performance problems in production apps.

How do I install the Supabase Debug skill?

skills CLI (Claude Code, Cursor, Codex and more): npx skills add wolverin0/claude-skills --skill supabase-debug. Skills go in ~/.claude/skills (personal) or .claude/skills (project), and Claude loads them automatically when a task matches the description.

Is Supabase Debug popular?

It lives in wolverin0/claude-skills, which has 41 GitHub stars and 1 forks.

Related skills

UI UX Pro Max

41

wolverin0/claude-skills

UI/UX design intelligence for web and mobile. Includes 50+ styles, 161 color palettes, 57 font pairings, 161 product types, 99 UX guidelines, and 25 chart types across 10 stacks (React, Next.js, Vue, Svelte, SwiftUI, React Native, Flutter, Tailwind, shadcn/ui, and HTML/CSS). Actions: plan, build, create, design, implement, review, fix, improve, optimize, enhance, refactor, and check UI/UX code. Projects: website, landing page, dashboard, admin panel, e-commerce, SaaS, portfolio, blog, and mobile app. Elements: button, modal, navbar, sidebar, card, table, form, and chart. Styles: glassmorphism,

Frontend & Design

Audit Blind Spots

41

wolverin0/claude-skills

Walk the B1-B19 AI-to-AI blind-spot catalog systematically. Use during the audit pipeline AFTER hard-stops and Tambon hunt and BEFORE the 13 domain audits. Output: PRESENT / NOT PRESENT for each B-class with evidence. Findings flow into the appropriate domains.

AI, LLMs & Agents

Audit Decisions

41

wolverin0/claude-skills

Standardize remediation decisions, baseline-policy entries, and legal-review banners for accepted, deferred, or policy-blocked audit findings.

Marketing, Sales & Business

Alphafold Database

43

lifangda/claude-plugins

Access AlphaFold's 200M+ AI-predicted protein structures. Retrieve structures by UniProt ID, download PDB/mmCIF files, analyze confidence metrics (pLDDT, PAE), for drug discovery and structural biology.

Databases13

Setup Compose Stack

45

pjt222/agent-almanac

Configure general-purpose Docker Compose stacks for common application patterns. Covers web app + database + cache + worker services, named volumes, networks, health checks, depends_on, environment management, and profiles. Use to run a web app with a database or cache, set up a dev environment with multiple services, orchestrate background workers alongside an API, or create reproducible multi-service environments.

DatabasesIn 1 list

Biorxiv Database

43

lifangda/claude-plugins

Efficient database search tool for bioRxiv preprint server. Use this skill when searching for life sciences preprints by keywords, authors, date ranges, or categories, retrieving paper metadata, downloading PDFs, or conducting literature reviews.

Databases13

Browse the most popular Claude skills, all databases skills, or write your own with the skills generator.