schema-exploration

List database tables, describe schemas, and map key relationships for SQL planning.

3|Updated Mar 16, 2026
One-click install
npx skills add https://github.com/bogware/bog-agents --skill schema-exploration-bogware
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: schema-exploration
Source: https://github.com/bogware/bog-agents/tree/main/examples/text-to-sql-agent/skills/schema-exploration
Command: npx skills add https://github.com/bogware/bog-agents --skill schema-exploration-bogware

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

This Skill helps you quickly understand an unknown database by turning raw table metadata into clear knowledge about what exists and how it connects.

Core Features & Use Cases

  • Table discovery: Identify what tables are available to query, including an at-a-glance overview of their roles.
  • Schema inspection: Retrieve column names, data types, primary/foreign keys, and a small set of sample rows to ground your understanding.
  • Relationship mapping: Trace how tables relate through foreign keys and common ID-based naming patterns to plan correct JOIN paths.

Quick Start

Ask the agent: Find the tables and key relationships needed to answer the question, including the columns and data types you should use.

Frequently Asked Questions about schema-exploration

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

FAQPage Schema
How do I discover database tables and map their relationships for SQL query planning?

Database schema discovery works by listing available tables, inspecting columns and data types, and mapping primary or foreign keys to trace table relationships. This process helps you identify correct JOIN paths and select relevant tables for business questions.

What's the best way to understand an unknown database schema before writing SQL?

Understanding an unknown database schema requires retrieving table metadata, column names, data types, and sample rows. By analyzing primary and foreign keys alongside common ID naming patterns, you can map table relationships and form accurate query plans.

How does schema discovery identify foreign keys and JOIN paths across tables?

Schema discovery identifies foreign keys and JOIN paths by extracting primary and foreign key constraints from table metadata and tracing common ID-based naming patterns to map how tables connect for SQL queries.

Can I inspect table columns, data types, and sample data to locate relevant fields for analytics?

Yes, schema inspection retrieves column names, data types, primary and foreign keys, and a small set of sample rows. This grounds your understanding of table structure and helps you locate the relevant fields needed for analytics tasks.

Do I need existing database connections or SQL tools to explore a schema?

Schema exploration requires access to database metadata through tools that can list tables and retrieve schema information. It relies on accessing primary and foreign key constraints, column definitions, and sample data to produce actionable schema summaries.