azure-cognitive-search
Expert knowledge for Azure AI Search development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building indexes, indexers, enrichment skillsets, semantic/vector search, or agentic answer synthesis, and other Azure AI Search related development tasks. Not for Azure Data Explorer (use azure-data-explorer), Azure Cosmos DB (use azure-cosmos-db), Azure SQL Database (use azure-sql-database), Azure Synapse Analytics (use azure-synapse-analytics).
npx skills add MicrosoftDocs/Agent-Skills --skill azure-cognitive-search --agent claude-code
Same command for any agent — swap --agent for codex, cursor, copilot.
Weekly change comes from our own snapshots, not the repository page — it measures attention, not adoption.
What it does
The skill provides expert knowledge for Azure AI Search development, covering troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It is intended for tasks like building indexes, indexers, enrichment skillsets, semantic/vector search, or agentic answer synthesis, and other Azure AI Search related development tasks.
How it works
- It directs the agent to use a Category Index to locate relevant sections. For categories with line ranges, it instructs reading specific lines via read_file. For categories with file links, it instructs reading the linked reference file.
- It requires network access to fetch documentation content, preferably via mcp_microsoftdocs:microsoft_docs_fetch with from=learn-agent-skill, or fallback to fetch_webpage with from=learn-agent-skill&accept=text/markdown.
- It includes a Category Index organizing topics (Troubleshooting, Best Practices, Decision Making, Architecture & Design Patterns, Limits & Quotas, Security, Configuration, Integrations & Coding Patterns, Deployment) with suggested sources for each topic.
- It provides explicit guidance to refresh version if metadata is older than 3 months and to install mcp_microsoftdocs if unavailable.
When to use it
Use when building and debugging Azure AI Search components such as indexes, indexers, enrichment skillsets, vector/semantic search, or agentic answer synthesis. Also used for architecture, capacity planning, security, and deployment considerations as described in the category topics.
What it can touch
Requires network access to fetch documentation content via:
- mcp_microsoftdocs:microsoft_docs_fetch (preferred)
- fetch_webpage (fallback)
Caveats
The skill requires network access. It relies on external documentation sources; availability depends on the external APIs and links listed. The metadata notes generation time and source tooling usage, but no operational guarantees are stated beyond fetching docs.
# Azure AI Search Skill This skill provides expert guidance for Azure AI Search. Covers troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. It combines local quick-reference content with remote documentation fetching capabilities. ## How to Use This Skill > **IMPORTANT for Agent**: Use the **Category Index** below to locate relevant sections. For categories with line ranges (e.g., `L35-L120`), use `read_file` with the specified lines. For categories with file links (e.g., `[security.md](security.md)`), use `read_file` on the linked reference file > **IMPORTANT for Agent**: If `metadata.generated_at` is more than 3 months old, suggest the user pull the latest version from the repository. If `mcp_microsoftdocs` tools are not available, suggest the user install it: [Installation Guide](https://github.com/MicrosoftDocs/mcp/blob/main/README.md) This skill requires **network access** to fetch documentation content: - **Preferred**: Use `mcp_microsoftdocs:microsoft_docs_fetch` with query string `from=learn-agent-skill`. Returns Markdown. - **Fallback**: Use `fetch_webpag
- How to Use This Skill
- Category Index
- Troubleshooting
- Best Practices
- Decision Making
- Architecture & Design Patterns
- Limits & Quotas
- Security
- Configuration
- Integrations & Coding Patterns
- Deployment
What does the azure-cognitive-search skill do?
Expert knowledge for Azure AI Search development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when building indexes, indexers, enrichment skillsets, semantic/vector search, or agentic answer synthesis, and other Azure AI Search related development tasks. Not for Azure Data Explorer (use azure-data-explorer), Azure Cosmos DB (use azure-cosmos-db), Azure SQL Database (use azure-sql-database), Azure Synapse Analytics (use azure-synapse-analytics).
How do I install it?
Run `npx skills add MicrosoftDocs/Agent-Skills --skill azure-cognitive-search --agent claude-code` — it drops the skill into your project so the agent can pick it up. Swap the --agent value for codex, cursor or copilot if you use one of those.
Where does this skill come from?
From MicrosoftDocs/Agent-Skills, a repository with 682 stars. We read it straight from the repository tree rather than a submitted listing, so what you see here is what is actually published.
Is a popular skill a good skill?
Not necessarily. Stars measure attention, not adoption — a repository can trend for a week and be abandoned. That is why we show the weekly change from our own snapshots next to the total, instead of a single flattering number.