azure-synapse-analytics
Expert knowledge for Azure Synapse Analytics development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when designing Synapse workspaces, SQL/Spark pools, PolyBase ELT, Synapse Link, or Purview/ML integrations, and other Azure Synapse Analytics related development tasks. Not for Azure Data Factory (use azure-data-factory), Azure Data Explorer (use azure-data-explorer), Azure Databricks (use azure-databricks), Azure HDInsight (use azure-hdinsight).
npx skills add MicrosoftDocs/Agent-Skills --skill azure-synapse-analytics --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 guidance for Azure Synapse Analytics, including troubleshooting, best practices, decision making, architecture and design patterns, limits and quotas, security, configuration, integrations and coding patterns, and deployment. It directs the agent to use a category index to locate relevant sections and to fetch remote documentation when needed. It specifies that the skill requires network access and can use a Microsoft Docs fetch tool or a fallback fetch to retrieve documentation. It distinguishes usage topics across Troubleshooting, Best Practices, Decision Making, Architecture & Design Patterns, Limits & Quotas, Security, Configuration, Integrations & Coding Patterns, and Deployment, with category-specific links and line ranges for content retrieval. It emphasizes keeping documentation up to date by checking the generated_at metadata and suggests installation of the fetch tools if unavailable.
How it works
- Instructs the agent to locate relevant sections using the Category Index.
- For categories with line ranges, use read_file on the specified lines.
- For categories with file links, use read_file on the linked reference file.
- If metadata.generated_at is older than 3 months, suggest pulling the latest version.
- If mcp_microsoftdocs tools are unavailable, suggest installing them via the provided Installation Guide.
- Requires network access to fetch documentation content.
- Uses preferred tool mcp_microsoftdocs:microsoft_docs_fetch with query from=learn-agent-skill; fallback to fetch_webpage with query from=learn-agent-skill&accept=text/markdown.
- Contains a Category Index table with topics and descriptions.
When to use it
Use when designing Synapse workspaces, SQL/Spark pools, PolyBase ELT, Synapse Link, Purview/ML integrations, and other Azure Synapse Analytics development tasks.
What it can touch
- Tools: claude-code, copilot, codex (as declared in requires).
- Network access to retrieve documentation via mcp_microsoftdocs:microsoft_docs_fetch or fetch_webpage.
Caveats
- Requires network access; content is fetched from remote documentation.
- Licensing noted as CC-BY-4.0 for the skill.
- The content relies on external documentation URLs and category-index-driven retrieval; accuracy depends on remote sources.
# Azure Synapse Analytics Skill This skill provides expert guidance for Azure Synapse Analytics. 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**: U
- 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-synapse-analytics skill do?
Expert knowledge for Azure Synapse Analytics development including troubleshooting, best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when designing Synapse workspaces, SQL/Spark pools, PolyBase ELT, Synapse Link, or Purview/ML integrations, and other Azure Synapse Analytics related development tasks. Not for Azure Data Factory (use azure-data-factory), Azure Data Explorer (use azure-data-explorer), Azure Databricks (use azure-databricks), Azure HDInsight (use azure-hdinsight).
How do I install it?
Run `npx skills add MicrosoftDocs/Agent-Skills --skill azure-synapse-analytics --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.