Skills
Skill 10 of 47
Foundry IQ knowledge bases.
2 minutes · 333 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. 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; 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, 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 23 September 2026.SKILL.md, not by matching a directory convention. 10 distinct layouts observed: .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-app-onboard/*/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 5 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.77 files · 1.2 MB
Everything this skill ships beside its prose. All of it is set here, as subchapters of skill 10.
Documentation the agent loads on demand, rather than up front.
Everything else published alongside the skill.
agents/5 files · 40 KB
helpers/48 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 · 8 KB