Debug RLS

by butterbase-ai

Debug RLS is a Quality skill for Claude Code, published by butterbase-ai in butterbase-skills.

532 stars40 forkson butterbase-ai/butterbase-skillsAdded 2026/08/26Repository updated 2026/06/28

View source on GitHub Download repo ZIP

agent-skillsai-agentsbackend-as-a-servicebutterbaseclaudeclaude-codemcpskills

Install in seconds

Install Debug RLS

Copy Debug RLS into your Claude Code skills folder. Run the command in your terminal, or review the source on GitHub before installing.

terminal

npx degit https://github.com/butterbase-ai/butterbase-skills/tree/main/skills/debug-rls ~/.claude/skills/debug-rls

Requires Node.js. Downloads this skill only — not the rest of the repository — into your Claude Code skills folder.

Without Node.js

git clone https://github.com/butterbase-ai/butterbase-skills.git

Clones the whole repository, then copy the skill’s own directory into your skills folder yourself.

In this catalog

Source file: skills/debug-rls/SKILL.md in butterbase-ai/butterbase-skills
Installs to: ~/.claude/skills/debug-rls
Collection: One of 25 skills cataloged from this repository
Category: Quality — 1354 skills

What Debug RLS does

Debug RLS helps troubleshoot Row-Level Security issues in Butterbase when users see access denied errors, wrong rows, or policy failures. It uses role simulation to test how policies behave for anon, user, and service requests.

Debug RLS is cataloged under Quality on DirSkills. Debug RLS comes from a repository tagged agent-skills, ai-agents, backend-as-a-service, butterbase and claude.

Documentation

README

Excerpt

debug-rls

Systematic methodology for debugging Row-Level Security issues in Butterbase. Uses role simulation (as_role/as_user parameters) to verify policy behavior without needing real user sessions.

1. Overview

Row-Level Security (RLS) in Butterbase controls which rows each database role can see or modify. When RLS is misconfigured, users may see no data, too much data, or get unexpected errors on insert. This skill walks through a repeatable four-step process to identify and fix the root cause.

Key principle: MCP tools default to the service key (bb_sk_...), which bypasses all RLS. Always use as_role/as_user to simulate the role your frontend actually uses.

This is the opening of the README. Read the full README on GitHub.

Frequently asked about Debug RLS

What else does butterbase-ai publish alongside Debug RLS?
Debug RLS is one of 25 skills that DirSkills catalogs from butterbase-ai/butterbase-skills, the repository it ships in. Its siblings there include Auth Setup, Build App and Butterbase AI Gateway. Each one is a separate skill with its own page in this directory, installs the same way Debug RLS does, and is maintained by butterbase-ai in that same repository. The rest of the collection is listed on the butterbase-ai/butterbase-skills page.
How does Debug RLS compare to other Quality skills?
Debug RLS ranks #1189 by stars among the 1354 Quality skills in this catalog. The most-starred ones next to it are Benchmark, Benchmark Optimization Loop and API Design Patterns. DirSkills ranks by the star count of the repository each skill ships in, so that order reflects how popular those repositories are rather than any review of Debug RLS against them. Open each page to compare what they document and how they install.