Skills
Skill 18 of 53
Foundry IQ knowledge bases.
2 minutes · 370 words
Install
npx skills add microsoft/azure-skills --skill foundry-iqnpx skills add microsoft/azure-skills/plugin marketplace add microsoft/azure-skillsThe first command installs just this skill, by the name in its SKILL.md; the second installs the whole repository.
Read one procedure before questions/actions; invocation is not a read.
Read the owning procedure before blocked/unsupported responses too.
Before mutation plans/approval, successfully read its required pre-action references, selected
branches only. Do not reload successful reads. On failure, try only permitted
bounded exact-path reads with any supported reader; never bypass restrictions
or search broadly. If still unavailable: blocked: reference-unavailable, name
missing references and inability to plan. Never invent requirements/plans.
Failures first.
Cleanup and receipt-backed execution go directly to their lifecycle/producer owner; do not reopen Search intake, provisioning or hardening.
Before expensive service discovery, reuse supplied resource/intent; otherwise ask one early USE EXISTING / FIND CANDIDATES / CREATE NEW choice. Only FIND enumerates; supplied identity uses exact/minimum scoped resolution. CREATE checks its proposed name, not existing-service inventories. Preserve these answers across source/KB/CU/model handoffs; selection is not write approval.
Searchable docs: KB + validated retrieval. Confirm intent once; KS-only must be explicit. Child success is not KB completion. Unclear/compound/mode/completion: read (opens in a new tab).
Route by requested operation, not existing KB source count. Connecting an existing KB with two or more sources, without changing the KB, uses Connect. Read-only operations use their owning procedure and actual helper constraints; this does not add retrieval modes or supported source kinds. Explicit unsupported provisioning or multi-source KB creation/reconfiguration uses Diagnose and stops before discovery, even when connecting an agent is also requested. This routing takes precedence over classic-search terms (e.g. hybrid search) in compound requests. Never end in a plain refusal: Diagnose gives the boundary, docs pointer and agent handoff; writes still need an approved concrete plan. Do not silently execute only the supported part of a compound request. If existing-KB connection versus KB creation/reconfiguration is unclear, read intent-routing and clarify that scope before Azure discovery. Never infer KB mutation.
| Outcome | Read |
|---|---|
| Cleanup | Plan cleanup (opens in a new tab) |
| Failure/drift | Diagnose (opens in a new tab) |
| Unsupported connector provisioning / multi-source KB creation or reconfiguration | Diagnose (opens in a new tab) |
| Connect | Connect (opens in a new tab) |
| Read KB | Query (opens in a new tab) |
| Search only | Search (opens in a new tab) |
| File KS only | File (opens in a new tab) |
| Blob/ADLS KS only | Blob (opens in a new tab) |
| Searchable/KB | KB (opens in a new tab) |
Generic agents: microsoft-foundry.
Reads: no approval; approve unchanged plans before writes.
Hide hashes. No Search/Storage keys, scope widening, guessed identity/boundaries,
drift repair or joint cleanup/creation approval. Acceptance != success.
Foundry IQ knowledge bases. WHEN: make local or Blob documents searchable; create/diagnose KBs; triage unsupported connectors or multi-source KB creation/reconfiguration (even with classic-search terms); connect existing KB to agents (including multi-source KBs); create/reuse a Search service; retrieve from an existing knowledge base with citations; no brand words needed. Read its procedure before query/target questions. NOT: other KB providers, repository-file search, classic Azure AI Search index/query/app work with no Foundry IQ KB or connector request, generic agent creation.
The verbatim description from this skill’s front matter — the string an agent matches on to decide whether to load it.
.github/plugins/foundry-iq-skills/skills/foundry-iq/SKILL.mdmain, last pushed 6 November 2026.SKILL.md, not by matching a directory convention. 11 distinct layouts observed: .github/plugins/aks-skills/skills/*/SKILL.md, .github/plugins/azure-advisor/skills/*/SKILL.md, .github/plugins/azure-cost/skills/*/SKILL.md, .github/plugins/azure-kusto-graph-skills/skills/*/SKILL.md, .github/plugins/azure-local-skills/skills/*/SKILL.md, .github/plugins/foundry-iq-skills/skills/*/SKILL.md, skills/*/SKILL.md, skills/azure-kubernetes/*/SKILL.md, skills/microsoft-foundry/*/SKILL.md, skills/microsoft-foundry/models/deploy-model/*/SKILL.md, skills/microsoft-foundry/models/*/SKILL.md.h1 and no skipped levels:.claude-plugin/marketplace.json by Microsoft, declaring 7 plugins. It is read for editorial metadata only — never as the skill index, which is always the repository tree./microsoft/azure-skills.md, and each skill at its own .md URL.84 files · 1.2 MB
Everything this skill ships beside its prose. All of it is set here, as subchapters of skill 18.
Documentation the agent loads on demand, rather than up front.
Everything else published alongside the skill.
agents/5 files · 39 KB
helpers/55 files · 1.0 MBknowledge-bases/2 files · 16 KB
knowledge-sources/2 files · 16 KB
lifecycle/1 file · 8 KB
search-services/1 file · 8 KB
troubleshooting/1 file · 9 KB