azure-files
Expert knowledge for Azure Files development including best practices, decision making, architecture & design patterns, limits & quotas, security, configuration, integrations & coding patterns, and deployment. Use when using Azure File Sync, cloud tiering, NFS/SMB shares, AVD FSLogix profiles, or RAG over Azure Files, and other Azure Files related development tasks. Not for Azure Blob Storage (use azure-blob-storage), Azure NetApp Files (use azure-netapp-files), Azure Virtual Machines (use azure-virtual-machines).
How do I install this agent skill?
npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-filesIs this agent skill safe to install?
- Gen Agent Trust Hubpass
This skill serves as an expert documentation assistant for Azure Files development. It directs the AI agent to fetch content from official Microsoft domains and provides links to official Microsoft-authored tools and repositories. No malicious patterns, obfuscation, or security vulnerabilities were detected.
- Socketpass
No alerts
- Snykpass
Risk: LOW · No issues
- ZeroLeakspass
Score: 93/100 · 2 sections analyzed
What does this agent skill do?
Azure Files Skill
This skill provides expert guidance for Azure Files. Covers 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), useread_filewith the specified lines. For categories with file links (e.g.,[security.md](security.md)), useread_fileon the linked reference file
IMPORTANT for Agent: If
metadata.generated_atis more than 3 months old, suggest the user pull the latest version from the repository. Ifmcp_microsoftdocstools are not available, suggest the user install it: Installation Guide
This skill requires network access to fetch documentation content:
- Preferred: Use
mcp_microsoftdocs:microsoft_docs_fetchwith query stringfrom=learn-agent-skill. Returns Markdown. - Fallback: Use
fetch_webpagewith query stringfrom=learn-agent-skill&accept=text/markdown. Returns Markdown.
Category Index
| Category | Lines | Description |
|---|---|---|
| Best Practices | L36-L51 | Best practices for Azure Files and File Sync: DR planning, server lifecycle changes, cloud tiering, handling large directories, and tuning SMB/NFS performance for workloads and Azure Virtual Desktop. |
| Decision Making | L52-L74 | Guidance for planning Azure Files deployments: choosing protocols, redundancy, billing, networking, migration paths, encryption, and Azure File Sync/cloud tiering topologies. |
| Architecture & Design Patterns | L75-L79 | Designing Azure Virtual Desktop hybrid architectures using Azure Files, including storage topology, identity/permissions, performance, and best practices for FSLogix profiles. |
| Limits & Quotas | L80-L87 | Azure Files and File Sync limits for capacity, IOPS, throughput, scalability, and API throttling behavior, to plan performance, sizing, and avoid hitting quotas. |
| Security | L88-L117 | Securing Azure Files and Azure File Sync: identity-based auth (AD DS, Entra, Kerberos), encryption, networking/firewalls, NTFS/ACLs, and secure mounting/permissions across Windows, Linux, and macOS. |
| Configuration | L118-L140 | Configuring Azure Files and Azure File Sync: setup, tiering, endpoints, redundancy, NFS mounts, share size/perf, and monitoring/alerts via Azure Monitor and change feed. |
| Integrations & Coding Patterns | L141-L165 | Patterns and code samples for building RAG pipelines over Azure Files (Haystack, LangChain, LlamaIndex), using Pinecone/Qdrant/Weaviate, auth and data access, and .NET/Java/Python app integration. |
| Deployment | L166-L174 | Guides for deploying Azure File Sync and migrating on-prem/NAS SMB/NFS data to Azure Files using portal/PowerShell/CLI, Storage Mover, and Data Box. |
Best Practices
Decision Making
Architecture & Design Patterns
| Topic | URL |
|---|---|
| Architect Azure Virtual Desktop Hybrid with Azure Files | https://learn.microsoft.com/en-us/azure/storage/files/azure-virtual-desktop-hybrid |
Limits & Quotas
| Topic | URL |
|---|---|
| Understand Azure File Sync scalability and performance targets | https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-scale-targets |
| Review Azure File Sync API throttling limits and behavior | https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-throttling |
| Reference Azure Files limits, quotas, and behaviors | https://learn.microsoft.com/en-us/azure/storage/files/storage-files-faq |
| Azure Files scalability, IOPS, and throughput limits | https://learn.microsoft.com/en-us/azure/storage/files/storage-files-scale-targets |
Security
Configuration
Integrations & Coding Patterns
Deployment
| Topic | URL |
|---|---|
| Deploy Azure File Sync with portal, PowerShell, CLI | https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-deployment-guide |
| Migrate on-premises SMB/NFS shares using Azure Storage Mover | https://learn.microsoft.com/en-us/azure/storage/files/migrate-files-storage-mover |
| Bulk migrate NAS data to Azure Files with Data Box | https://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-nas-cloud-databox |
| Migrate NAS SMB shares to Azure File Sync hybrid | https://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-nas-hybrid |
| Migrate NAS to Azure File Sync via Data Box | https://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-nas-hybrid-databox |
| Migrate Windows Server data into Azure File Sync with Data Box | https://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-server-hybrid-databox |
How can the creator link this skill?
Add the canonical catalog link to the repository README so users can inspect current installs and available audits. The publishing guide covers the complete discovery path.
<a href="https://skillzs.dev/skills/microsoftdocs/agent-skills/azure-files">View azure-files on skillZs</a>