About azure-files
A guidance skill for Azure Files users and agents, combining local references with fetched documentation on storage planning, security, operations, integrations, and migration.
Key features
- 01Best practices and deployment planning
- 02Tier, protocol, and redundancy choices
- 03Limits and performance guidance
- 04Security and configuration
- 05Integrations and migration patterns
Use cases
- 01Plan an Azure Files deployment
- 02Tune SMB or NFS performance
- 03Secure file shares
- 04Migrate data to Azure Files
MCP support
The skill can fetch documentation through the mcp_microsoftdocs:microsoft_docs_fetch tool, with webpage fetching as a fallback.
Install
Copy the command and run it in a terminal.
npx skills add https:/After installing, type/azure-filesin Claude Code to confirm it loaded.
Details
From the project READMEAzure 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-L72 | Guidance for planning Azure Files deployments: choosing tiers, redundancy, protocols, billing models, migration approaches, and management/topology options for SMB and NFS workloads. |
| Architecture & Design Patterns | L73-L77 | Designing Azure Virtual Desktop hybrid architectures using Azure Files, including storage topology, identity/permissions, performance, and best practices for FSLogix profiles. |
| Limits & Quotas | L78-L85 | Azure Files and File Sync limits for capacity, IOPS, throughput, scalability, and API throttling behavior, to plan performance, sizing, and avoid hitting quotas. |
| Security | L86-L116 | Securing Azure Files and File Sync: identity-based SMB/NFS auth, Kerberos/AD/Entra setup, firewalls, network endpoints, TLS, encryption keys, NTFS ACLs, and share-level permissions. |
| Configuration | L117-L141 | Configuring Azure Files and Azure File Sync: VPN connectivity, endpoints/DNS, redundancy and performance, cloud tiering, monitoring/metrics/logs, alerts, and file copy/change feed. |
| Integrations & Coding Patterns | L142-L164 | RAG integrations with Azure Files using Haystack, LangChain, LlamaIndex, Pinecone/Qdrant/Weaviate, plus code patterns for .NET, Java, and Python apps accessing Azure Files. |
| Deployment | L165-L173 | Deploying Azure File Sync and migrating data to Azure Files from SMB/NFS shares, NAS, Linux servers, GlusterFS, using tools like Storage Mover, Data Box, Robocopy, portal, CLI, and PowerShell. |
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 data between Azure file shares with File Sync | https://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-share-to-share-migration |
| Migrate GlusterFS volumes to Azure Files | https://learn.microsoft.com/en-us/azure/storage/files/glusterfs-migration-guide |
| Migrate SMB/NFS shares to Azure Files with Storage Mover | https://learn.microsoft.com/en-us/azure/storage/files/migrate-files-storage-mover |
| Migrate NAS SMB shares to Azure File Sync hybrid | https://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-nas-hybrid |
| Migrate to SMB Azure file shares using Robocopy | https://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-robocopy |