discovering-gcp-data-assets

Discovers and inspects Google Cloud data assets using Dataplex search and context lookup.

1|Updated Mar 19, 2026
One-click install
npx skills add https://github.com/tottenjordan/me-skittles --skill discovering-gcp-data-assets-tottenjordan
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: discovering-gcp-data-assets
Source: https://github.com/tottenjordan/me-skittles/tree/main/gemini/discovering-gcp-data-assets
Command: npx skills add https://github.com/tottenjordan/me-skittles --skill discovering-gcp-data-assets-tottenjordan

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? Locating the right data asset in Google Cloud is hard when you only have a keyword or topic, and retrieving schema, metadata, and governance context for BigQuery, Spanner, BigLake, or Cloud Storage assets requires knowing exact resource IDs. This Skill guides an agent through Dataplex catalog search and context lookup to find assets and fetch their full metadata. ## Core Features & Use Cases - Semantic and Keyword Search: Search the Dataplex Universal Catalog with natural language intent (e.g., "Q4 product sales data") or precise keyword syntax (e.g., name:order_v2, system=bigquery). - Schema and Metadata Lookup: Retrieve detailed schema, business context, and governance metadata via the Dataplex context lookup command using full entry names. - Public Dataset Handling: Detects bigquery-public-data assets and falls back to direct inspection with the bq CLI or BigQuery MCP tools. - Use Case: A user asks "find the sales tables in our GCP project and show me their columns." The Skill runs a Dataplex semantic search, resolves the full entry name, and returns the table schema and metadata. ## Quick Start Ask the agent to find BigQuery tables related to customer orders in your GCP project and show their schemas.

Frequently Asked Questions about discovering-gcp-data-assets

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

FAQPage Schema
How do I find BigQuery tables in Google Cloud by keyword?▼

Use the Dataplex search command with a keyword query such as `gcloud dataplex entries search "name:sales" --project=<PROJECT_ID>`. Keyword search supports filters like `system=bigquery`, `location=us`, and `parent:projects/<PROJECT_ID>` to narrow results.

How do I search GCP data assets with natural language?▼

Use Dataplex semantic search by adding the `--semantic-search` flag to `gcloud dataplex entries search`. Describe the meaning of the data, such as "Q4 product sales data", and the catalog returns matching assets with their full entry names.

Why does Dataplex context lookup fail with NOT_FOUND?▼

Lookup fails when a short table ID is passed instead of the full entry name starting with `projects/`, or when the asset's project has not synchronized metadata with the Dataplex Universal Catalog. Fall back to native tools like `bq show` for direct inspection.

Can I inspect bigquery-public-data tables with Dataplex?▼

No, Dataplex Lookup Context fails for assets in the `bigquery-public-data` project. Inspect these public datasets directly using the `bq` CLI or BigQuery MCP tools instead of the catalog search flow.

What permissions are required for Dataplex search?▼

The project passed via `--project` must have the Dataplex API enabled, and the user must have the `dataplex.entries.get` permission. Without these, searches fail with PERMISSION_DENIED errors.

What should I do when Dataplex search returns no results?▼

Try at most three query variations, such as switching AND/OR clauses, removing `projectid:` or `location:` filters, or using `fully_qualified_name=`. If still empty, stop and ask the user for the project, dataset, or instance ID.