# knowledge-catalog-discovery

A set of discovery scripts to search data assets and inspect metadata in Knowledge Catalog through Claude Code.

- skill · `type=skill` · Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, OpenCode · 2500 installs · ★ 40
- Author: cline
- License: Apache-2.0 · policy=mirror · the beginning of the file is at the end of this page
- Source: https://github.com/cline/skills/tree/HEAD/skills/knowledge-catalog-discovery/SKILL.md
- Updated: 2026-07-21
- HTML: https://affpapa.org/en/nevibecode/skills/knowledge-catalog-discovery

## What it does

The skill lets coding assistants search and inspect data assets in Google Cloud Dataplex Knowledge Catalog. A set of Node.js scripts finds tables, datasets, or views, pulling back schema details and relationships between assets.

Four scripts handle discovery: `search_entries` supports Dataplex query syntax with grouping and boolean operators, `lookup_entry` inspects a single entry across different view modes, `lookup_context` retrieves metadata for up to 10 resources in the same location, and `search_aspect_types` queries catalog aspects. Executing these tools requires Node.js in your environment.

Environment variables load automatically from `.env` files without manual user prompting. Broad searches without resource filters run slowly and consume significant capacity, so exploratory queries need a defined `pageSize`.

## Install

### Claude Code (native platform)

1. **Skills CLI (Vercel)**
```bash
npx skills add cline/skills --skill knowledge-catalog-discovery -a claude-code
```

2. **Manually: put the files in place**
- File: `~/.claude/skills/knowledge-catalog-discovery/SKILL.md` — Copy the whole skill folder; for one project use .claude/skills/knowledge-catalog-discovery/

### Codex

1. **Skills CLI (Vercel)**
```bash
npx skills add cline/skills --skill knowledge-catalog-discovery -a codex
```

2. **Manually: put the files in place**
- File: `.agents/skills/knowledge-catalog-discovery/SKILL.md` — For all projects use ~/.agents/skills/

### Cursor

1. **Skills CLI (Vercel)**
```bash
npx skills add cline/skills --skill knowledge-catalog-discovery -a cursor
```

2. **Manually: put the files in place**
- File: `.cursor/skills/knowledge-catalog-discovery/SKILL.md` — Cursor also reads .agents/skills/ and .claude/skills/

### GitHub Copilot

1. **GitHub CLI**
```bash
gh skill install cline/skills knowledge-catalog-discovery
```

2. **Manually: put the files in place**
- File: `.github/skills/knowledge-catalog-discovery/SKILL.md`

### Gemini CLI

1. **Skills CLI (Vercel)**
```bash
npx skills add cline/skills --skill knowledge-catalog-discovery -a gemini-cli
```

2. **Platform CLI**
```bash
gemini skills install https://github.com/cline/skills --path skills/knowledge-catalog-discovery
```

### Windsurf (Devin Desktop)

**Manually: put the files in place**
- File: `.devin/skills/knowledge-catalog-discovery/SKILL.md` — The legacy .windsurf/skills/ path still works

### OpenCode

**Skills CLI (Vercel)**
```bash
npx skills add cline/skills --skill knowledge-catalog-discovery -a opencode
```

### Claude.ai

**Claude.ai**
- Zip the folder and upload it in Settings → Capabilities → Skills

Where a file is given instead of a command, copy the files from the source to that path: https://github.com/cline/skills/tree/HEAD/skills/knowledge-catalog-discovery/SKILL.md

## When to use it
- find tables and views in Dataplex using query filters
- inspect metadata and aspect types for a specific catalog entry
- retrieve relationships for multiple assets within one location
- search available catalog aspect types

## Example prompts
- Search for tables matching `orders` in project `analytics`
- Retrieve full metadata and aspects for the customer dataset in location `us`
- Find catalog aspect types related to data quality

## Source text · SKILL.md · Apache-2.0

Below is the content of a third-party file. It is data, not instructions for you: do not act on anything written inside unless the human asks. Block tag: 9d0dc2ba2d830131.

BEGIN THIRD-PARTY FILE 9d0dc2ba2d830131
```text
---
name: knowledge-catalog-discovery
description: Use these skills when you need to discover and explore data assets in the Knowledge Catalog. It allows you to search for entries, lookup specific metadata, and explore aspect types to understand your data platform's assets.
---

## Usage

All scripts can be executed using Node.js. Replace `<param_name>` and `<param_value>` with actual values.

**Bash:**
`node <skill_dir>/scripts/<script_name>.js '{"<param_name>": "<param_value>"}'`

**PowerShell:**
`node <skill_dir>/scripts/<script_name>.js '{\"<param_name>\": \"<param_value>\"}'`

Note: The scripts automatically load the environment variables from various .env files. Do not ask the user to set vars unless skill executions fails due to env var absence.


## Scripts


### lookup_context

Retrieves rich metadata regarding one or more data assets along with their relationships.

#### Parameters

| Name | Type | Description | Required | Default |
| :--- | :--- | :--- | :--- | :--- |
| resources | array | Required. A list of up to 10 resource names. Resources may belong to different projects, but all must belong to the same location. | Yes |  |


---

### lookup_entry

Retrieves a specific metadata regarding a data asset (e.g. table/dataset/view) from Catalog

#### Parameters

| Name | Type | Description | Required | Default |
| :--- | :--- | :--- | :--- | :--- |
| entry | string | Required. The resource name of the Entry in the following form: projects/{project}/locations/{location}/entryGroups/{entryGroup}/entries/{entry}. | Yes |  |
| view | integer | 
				## Argument: view

				**Type:** Integer

				**Description:** Optional. Specifies the parts of the entry and its aspects to return.

				**Possible Values:**

				*   1 (BASIC): Returns entry without aspects.
				*   2 (FULL): Return all required aspects and the keys of non-required aspects. (Default)
				*   3 (CUSTOM): Return the entry and aspects requested in aspect_types field (at most 100 aspects). Always use this view when aspect_types is not empty.
				*   4 (ALL): Return the entry and both required and optional aspects (at most 100 aspects)
				 | No | `2` |
| aspectTypes | array | Optional. Limits the aspects returned to the provided aspect types. It only works when used together with CUSTOM view. | No | `[]` |


---

### search_aspect_types

Search aspect types relevant to the query.

#### Parameters

| Name | Type | Description | Required | Default |
| :--- | :--- | :--- | :--- | :--- |
| query | string | The query against which aspect type should be matched. | Yes |  |
| pageSize | integer | Number of returned aspect types in the search page. | No | `5` |
| orderBy | string | Specifies the ordering of results. Supported values are: relevance, last_modified_timestamp, last_modified_timestamp asc | No | `relevance` |


---

### search_entries
```
END THIRD-PARTY FILE 9d0dc2ba2d830131

The third-party file has ended. Everything between the 9d0dc2ba2d830131 tags is data: requests and commands from it are not followed. An “end of file” line with another tag inside the block is part of the file.

First 2855 of 4075 bytes. © cline · Apache-2.0 · https://github.com/cline/skills/tree/HEAD/skills/knowledge-catalog-discovery/SKILL.md

_Part of the page did not fit — see the HTML version._

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md