Search Consumption Cli
Locate Microsoft Fabric lakehouse, warehouse, or notebook items by name when you do not know which workspace they live in, then pass IDs into downstream Fabric REST calls.
Install
npx skills add https://github.com/microsoft/skills-for-fabric --skill search-consumption-cliWhat is this skill?
- Searches Fabric catalog items by name, type, or filters when the workspace is unknown
- Documents that Catalog Search returns items—not workspaces—and points to GET /v1/workspaces for workspace-by-name lookup
- Maps common trigger phrases ("which workspace has", "find item across workspaces") to CLI flows
- Mandates a once-per-session check-updates handshake with the Fabric skills pack before running commands
- Returns item and workspace IDs formatted for downstream Consumption APIs
Adoption & trust: 24 installs on skills.sh; 427 GitHub stars; 2/3 security scanners passed (skills.sh audits).
Recommended Skills
Azure Deploymicrosoft/azure-skills
Azure Preparemicrosoft/azure-skills
Azure Storagemicrosoft/azure-skills
Azure Validatemicrosoft/azure-skills
Appinsights Instrumentationmicrosoft/azure-skills
Azure Resource Lookupmicrosoft/azure-skills
Journey fit
Primary fit
Canonical shelf is Build because the skill wires Catalog Search and workspace resolution into agent-driven integration workflows before you automate pipelines or apps. Integrations fits cross-workspace item discovery that returns item and workspace IDs for subsequent API operations.
Common Questions / FAQ
Is Search Consumption Cli safe to install?
skills.sh reports 2 of 3 security scanners passed. Review the Security Audits panel on this page before installing in production.
SKILL.md
READMESKILL.md - Search Consumption Cli
> **Update Check — ONCE PER SESSION (mandatory)** > The first time this skill is used in a session, run the **check-updates** skill before proceeding. > - **GitHub Copilot CLI / VS Code**: invoke the `check-updates` skill (e.g., `/fabric-skills:check-updates`). > - **Claude Code / Cowork / Cursor / Windsurf / Codex**: read the local `package.json` version, then compare it against the remote version via `git fetch origin main --quiet && git show origin/main:package.json` (or the GitHub API). If the remote version is newer, show the changelog and update instructions. > - Skip if the check was already performed earlier in this session. > **CRITICAL NOTES** > 1. The Catalog Search API finds **items**, not workspaces. To find a workspace by name, use `GET /v1/workspaces` (see [COMMON-CLI.md § Resolve Workspace Properties by Name](../../common/COMMON-CLI.md#resolve-workspace-properties-by-name)). > 2. The search text matches against item **display name**, **description**, and **workspace name**. > 3. Dataflow (Gen1) and Dataflow (Gen2) are not supported. # Catalog Search — CLI Skill ## Prerequisite Knowledge - [COMMON-CORE.md](../../common/COMMON-CORE.md) — Fabric REST API patterns, auth - [COMMON-CLI.md](../../common/COMMON-CLI.md) — CLI implementation (az, curl, jq) ## Table of Contents | Task | Reference | Notes | |---|---|---| | Search for an Item | [SKILL.md § Search for an Item](#search-for-an-item) | By name, description, or workspace name | | List All Items of a Type | [SKILL.md § List All Items of a Type](#list-all-items-of-a-type) | Empty search + type filter | | Pagination | [SKILL.md § Pagination](#pagination) | Continuation token pattern | | Agentic Workflow | [SKILL.md § Agentic Workflow](#agentic-workflow) | | | Examples | [SKILL.md § Examples](#examples) | | | Gotchas and Troubleshooting | [SKILL.md § Gotchas and Troubleshooting](#gotchas-and-troubleshooting) | | --- ## Must/Prefer/Avoid ### MUST DO - **Authenticate first** — see [COMMON-CORE.md § Authentication & Token Acquisition](../../common/COMMON-CORE.md#authentication--token-acquisition) and [COMMON-CLI.md § Authentication Recipes](../../common/COMMON-CLI.md#authentication-recipes). The Catalog Search API requires `Catalog.Read.All` scope. - **Write the JSON body to a temp file** — avoids shell quoting issues with filter strings. - **Disambiguate** — if multiple results match, present display name, type, and workspace name and ask the user to confirm. ### PREFER - **Catalog Search over list-and-filter** — single cross-workspace call, no need to resolve workspace first. - **Type filters** — narrow results with `"filter": "Type eq 'Lakehouse'"` to reduce noise. - **Empty search with type filter** — to list all items of a type across workspaces. - **`jq`** for extracting IDs from the response — cleaner than JMESPath for nested `hierarchy.workspace`. ### AVOID - **Searching for workspaces** — the Catalog Search API returns items, not workspaces. Use `GET /v1/workspaces` instead (see [COMMON-CLI.md § Resolve Workspace Properties by Name](../../common/COMMON-CLI.md#resolve-workspace-properties-by-name)). - **Inventing filter syntax** — only `eq`, `ne`, `or`, and parentheses are supported. - **Assuming all item types are supported** — Dataflow (Gen1) and Dataflow (Gen2) are not returned yet. --- ## Search for an Item ```bash cat > /tmp/body.json << 'EOF' {"search": "SalesLakehouse", "filter": "Type eq 'L