prod-db-connect

Connect to production Cloud SQL Postgres databases for inspection and targeted fixes.

Updated Aug 27, 2026
One-click install
npx skills add https://github.com/neon-law-foundation/navigator --skill prod-db-connect
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: prod-db-connect
Source: https://github.com/neon-law-foundation/navigator/tree/main/.claude/skills/prod-db-connect
Command: npx skills add https://github.com/neon-law-foundation/navigator --skill prod-db-connect

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you securely inspect and correct live production database data when a targeted fix or verification is needed, without relying on hard-coded project or instance details.

Core Features & Use Cases

  • Production Inspection: Connect to the Cloud SQL Postgres database for read-only investigation of live rows and schema-adjacent issues.
  • Targeted Data Fixes: Perform carefully scoped updates for existing production records when the canonical seed no longer reaches them.
  • Safe Operational Workflow: Use IAM service-account impersonation, a temporary proxy session, and explicit approval before any write.
  • Use Case: A lawyer-facing app shows the wrong value in production, and you need to verify the row, prepare the exact update, and apply it safely with verification afterward.

Quick Start

Use the prod-db-connect skill to discover the production Cloud SQL Postgres connection, inspect the live data you need, and stage any required update for explicit approval before writing.

Frequently Asked Questions about prod-db-connect

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

FAQPage Schema
How do I safely connect to a production Postgres database for ad hoc inspection?

To safely connect to a production Postgres database for ad hoc inspection, use cloud-sql-proxy with IAM service-account impersonation to establish a temporary session that dynamically discovers Cloud SQL settings and requires explicit approval before any write operations.

Can I run targeted data fixes on existing production records without hard-coding instance details?

Yes, targeted data fixes on production records are possible by dynamically discovering Cloud SQL project and instance settings, staging the exact update, and applying transaction guards that require logged approval before any write operation is executed.

What is IAM impersonation and how does it secure Cloud SQL Postgres connections?

IAM impersonation secures Cloud SQL Postgres connections by using service-account delegation rather than static credentials. Combined with cloud-sql-proxy, it ensures production database access is authenticated, scoped to the session, and requires logged approval for writes.

Does this approach support verifying live rows in production before applying updates?

Yes, the workflow supports verifying live rows in production before applying updates by enabling read-only investigation of schema-adjacent issues and existing records. You inspect the live data, prepare the exact update, and verify it safely post-write using transaction guards.

What are the limitations of using cloud-sql-proxy for production database support?

Limitations of using cloud-sql-proxy for production database support include its restriction to Cloud SQL Postgres instances and the strict requirement for logged approval and transaction guards before any write, making it unsuitable for automated or unattended bulk data migrations.