supabase-schema-catalog

Generate an offline JSON catalog of a Supabase Postgres schema.

5|2|Updated Nov 20, 2025
One-click install
npx skills add https://github.com/Insightpulseai/odoo --skill supabase-schema-catalog
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: supabase-schema-catalog
Source: https://github.com/Insightpulseai/odoo/tree/main/skills/user/supabase-schema-catalog
Command: npx skills add https://github.com/Insightpulseai/odoo --skill supabase-schema-catalog

SYSTEM DOCUMENTATION & REQUIREMENTS

💡 This Skill requires psql, and includes scripts (resource) components.

What problem does it solve?

This skill provides an offline JSON catalog of a PostgreSQL database schema (Supabase) to enable schema-aware automation without repeatedly querying the live database.

Core Features & Use Cases

  • Offline schema knowledge: Stores table and column metadata in a portable JSON catalog.
  • Automated SQL guidance: Helps agents generate migrations, documentation, and mappings without live DB access.
  • Use Case: When building AI-driven data pipelines or Odoo integrations, use this catalog to map tables to domain entities and verify schemas.

Quick Start

  • From the skill directory, run the catalog generator to build or refresh catalog/schema_catalog.json using scripts/build_schema_catalog.sh.

Frequently Asked Questions about supabase-schema-catalog

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

FAQPage Schema
How do I get an offline schema catalog for Supabase to generate SQL without live database access?

Yes, you can generate SQL migrations offline by using the JSON catalog of your Supabase Postgres schema. The catalog stores table and column metadata, allowing AI agents to generate migrations, documentation, and mappings without live DB access.

What prerequisites are needed to build a Supabase schema catalog offline?

Building a Supabase schema catalog requires a working SUPABASE_DB_URL environment variable, a read-only database user, and psql installed. You run the build_schema_catalog.sh script to produce the JSON output for your agents.

Can I use an offline schema catalog to map data models across Supabase and Odoo during migrations?

An offline Supabase schema catalog stores your Postgres table and column metadata in a portable JSON format. This allows AI agents and automation workflows to access schema structure for generating SQL and mapping data models without live queries.

How do I refresh the offline JSON catalog of my Supabase Postgres schema?

To automate Supabase schema documentation, load the offline JSON catalog into your AI agent. The catalog contains the structural metadata needed to automatically generate documentation, verify schemas, and guide SQL generation without live database queries.

Does generating a Supabase schema catalog require a live database connection or query access?

Generating the initial Supabase schema catalog requires a live database connection via the SUPABASE_DB_URL environment variable and a read-only database user. Once the JSON catalog is built, subsequent schema-aware automation requires no live database queries.

What is an offline Supabase schema catalog used for in AI workflows?

After building the Supabase schema catalog, use the JSON metadata to generate SQL migrations, map tables to domain entities across Odoo and analytics pipelines, document schemas, and drive schema-aware automation during feature rollouts or migrations.