Query Supabase Database

Execute PostgreSQL commands on Supabase databases using psql with 1Password credentials.

Updated Aug 29, 2025
One-click install
npx skills add https://github.com/bigandslow/cproj --skill query-supabase-database
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: Query Supabase Database
Source: https://github.com/bigandslow/cproj/tree/main/.claude/skills/query-supabase
Command: npx skills add https://github.com/bigandslow/cproj --skill query-supabase-database

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

Securely query a Supabase PostgreSQL database by retrieving credentials from 1Password and executing SQL commands via psql, eliminating manual credential handling.

Core Features & Use Cases

  • Secure Credential Retrieval: fetches database passwords from 1Password at runtime.
  • Ad-hoc SQL Queries: run SELECT, INSERT, UPDATE, and ALTER statements against the database.
  • Data Exploration & Testing: inspect tables, describe schemas, and validate migrations in development and CI pipelines.

Quick Start

Run a sample query against your Supabase database using credentials retrieved from 1Password.

Frequently Asked Questions about Query Supabase Database

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I securely query a Supabase database without hardcoding the password?

To securely query a Supabase database without hardcoding passwords, this skill retrieves credentials from 1Password at runtime and executes SQL commands via psql. It eliminates manual credential handling by fetching the password dynamically for ad-hoc data exploration.

Can I run schema inspections and validate migrations on Supabase using psql?

Yes, you can validate migrations and inspect schemas on Supabase using psql. This skill executes PostgreSQL commands to describe tables and run routine database checks, making it suitable for data exploration and testing in development workflows.

Do I need 1Password and psql installed to run SQL commands against Supabase?

Yes, you need both 1Password and psql to run SQL commands against Supabase with this skill. 1Password securely retrieves the database password, while psql is required to execute the PostgreSQL statements against your valid Supabase connection endpoint.

What is the best way to execute ad-hoc PostgreSQL statements on a Supabase database?

The best way to execute ad-hoc PostgreSQL statements on a Supabase database is using psql with dynamically retrieved credentials. This skill fetches passwords from 1Password to run SELECT, INSERT, UPDATE, and ALTER statements securely without manual environment setup.

What are the limitations of using psql and 1Password for routine Supabase database checks?

Limitations of using psql and 1Password for routine Supabase database checks include the strict dependency on having both tools configured. Execution requires a valid Supabase connection endpoint and network access to 1Password to retrieve credentials successfully at runtime.