foundry-iq-skills — Claude Code plugin for Foundry IQ knowledge bases
Builds Foundry IQ knowledge bases from files, Azure Blob or ADLS Gen2, checks that retrieval works, and wires the base into an agent.
/plugin marketplace add microsoft/skills
/plugin install foundry-iq-skills@skillsWhat foundry-iq-skills does
Microsoft's plugin walks through the Azure AI Search (Foundry IQ) workflow: create or reuse a service, add a knowledge source from local files, Blob Storage or Data Lake Storage, build the knowledge base, then confirm its content is searchable. From there you can query it with citations or attach it to an existing Prompt or Hosted Agent.
One skill, foundry-iq, does the work. A track-telemetry hook installs a pinned ghcfa-telem release asset, verifies the platform-specific SHA-256 digest before extraction, and caches the executable. To opt out, set AZURE_MCP_COLLECT_TELEMETRY=false in the environment of the process running the agent.
The skill starts with read-only checks and asks whether to use an existing service, find a compatible one, or create a new one. Creating a service, knowledge source or knowledge base, and connecting a base to an agent, all need your approval, and the skill asks again if the plan changes. You need Git to add the marketplace, GitHub Copilot CLI, Python 3.12 or later for the helper scripts, plus access to the Azure subscriptions and an authenticated identity with the right permissions. With Azure CLI auth, sign in via az login. Classic Azure AI Search application, index or query development, generic agent creation and repository-file search are out of scope — worth checking before you install.
What it helps with
- build a knowledge base from a folder of documents
- index content from Azure Blob Storage or ADLS Gen2
- verify that a knowledge base is actually searchable
- get answers with citations from an existing base
- debug why retrieval from a knowledge base fails
Example prompts for the agent
- Create a knowledge base from
./docs. - Create a knowledge base from this Blob container.
- Query this knowledge base with citations.
How to install foundry-iq-skills
Plugin marketplace
/plugin marketplace add microsoft/skills/plugin install foundry-iq-skills@skillsStep by step, with commands for each platform: Claude Code plugins: marketplaces, installing, and building your own
Questions about foundry-iq-skills
How do I install foundry-iq-skills in Claude?
Run two commands in order: /plugin marketplace add microsoft/skills, then /plugin install foundry-iq-skills@skills.
What does foundry-iq-skills do?
It creates or reuses Azure AI Search (Foundry IQ) services, builds knowledge sources from files, Blob Storage or ADLS Gen2, validates retrieval, and connects the base to an agent.
What do I need before using it?
Git to add the marketplace, GitHub Copilot CLI, Python 3.12 or later for the helper scripts, and an authenticated Azure identity with permissions for the requested read or change.
Source text
foundry-iq-skills · MIT
# Foundry IQ Skills Build grounded knowledge experiences with [Azure AI Search (Foundry IQ)](https://learn.microsoft.com/azure/search/agentic-retrieval-overview). This plugin helps GitHub Copilot CLI create and use Foundry IQ knowledge bases, using your existing Azure resources when possible. ## Telemetry The `track-telemetry` hook installs a pinned native `ghcfa-telem` release asset when needed, verifies its platform-specific SHA-256 digest before extraction, and caches the executable for reuse. To opt out of telemetry collection, set `AZURE_MCP_COLLECT_TELEMETRY=false` in the environment of the process running the agent. ## Skill - **foundry-iq**: Build, connect, query, and troubleshoot Foundry IQ knowledge experiences using supported Azure resources. ## What it helps with - Create or reuse an Azure AI Search (Foundry IQ) service - Create a File knowledge source from local files - Create a knowledge source from Azure Blob Storage or Azure Data Lake Storage - Create a knowledge base and validate that its content is searchable - Query an existing knowledge base and return citations - Connect an existing knowledge base to an agent - Diagnose knowledge base failures and unsupported requests - Prepare a cleanup plan for resources created by the workflow The skill is intended for Foundry IQ knowledge-base workflows. It does not support classic Azure AI Search (Foundry IQ) application, index, or query development, generic agent creation, or repository-file search. ## Prerequisites - [Git](https://git-scm.com/downloads), required to add the plugin marketplace - [GitHub Copilot CLI](https://github.com/github/copilot-cli) - [Python 3.12 or later](https://www.python.org/downloads/), required to run the plugin's helper scripts - Access to the Azure subscriptions and resources involved in your request - An authenticated Azure identity with the permissions required for the requested read or change If you use Azure CLI for authentication, install the [Azure CLI](https://learn.microsoft.com/cli/azure/install-azure-cli) and sign in: ```bash az login ``` The plugin supports Copilot CLI on Windows and Linux. Depending on the task, it uses supported Azure SDK, REST, infrastructure-as-code, Azure MCP Server, or native knowledge-base MCP interfaces. ## Installation Run these commands in Copilot CLI: ```text /plugin marketplace add microsoft/azure-skills /plugin install foundry-iq-skills@azure-skills ``` To update the plugin: ```text /plugin update foundry-iq-skills@azure-skills ``` ## Example prompts - "Create a knowledge base from `./docs`." - "Create a knowledge base from this Blob container." - "Query this knowledge base with citations." - "Connect this knowledge base to my existing agent." - "Why is retrieval from this knowledge base failing?" ## Before changes are made The skill starts with read-only checks and can reuse Azure resources you identify. It asks whether to use an existing service, find compatible services, or create a new one before performing broader discovery. It asks for your approval before it: - Creates an Azure AI Search (Foundry IQ) service, knowledge source, or knowledge base - Connects a knowledge base to an agent - Makes another planned change to Azure resources Approval applies to the plan shown to you. If the plan changes, the skill asks again. Cleanup is handled as a separate planning workflow. The skill can also perform supported deletion of workflow-owned resources after separate approval. ## Learn more - [Azure AI Search (Foundry IQ) overview](https://learn.microsoft.com/azure/search/search-what-is-azure-search) - [Foundry IQ and agentic retrieval](https://learn.microsoft.com/azure/search/agentic-retrieval-overview) - [Azure AI Search (Foundry IQ) API and SDK versions](https://learn.microsoft.com/azure/search/search-api-versions) - [Azure AI Search (Foundry IQ) REST API](https://learn.microsoft.com/en-us/rest/api/searchservice/?source=recommendations) - [Azure MCP Server tools for Azure AI Search (Foundry IQ)](https://learn.microsoft.com/azure/developer/azure-mcp-server/tools/azure-ai-search) - [Foundry IQ skill details](skills/foundry-iq/SKILL.md)
© Microsoft · MIT · microsoft/skills
