Now liveThe Skillselion MCP - thousands of ranked skills, loaded into your agent mid-task. No install.Get it →
microsoftdocs avatar

Azure Files

  • 124 installs
  • 682 repo stars
  • Updated August 3, 2026
  • microsoftdocs/agent-skills

Helps with ai & agent building tasks during AI-assisted development.

About

azure-files is a Claude Code skill for ai & agent building. It helps solo builders move faster with AI-assisted coding.

  • azure-files
  • AI & Agent Building
  • AI-coding skill

Azure Files by the numbers

  • 124 all-time installs (skills.sh)
  • +12 installs in the week ending Aug 4, 2026 (Skillselion tracking)
  • Ranked #3,781 of 16,546 AI & Agent Building skills by installs in the Skillselion catalog
  • Data as of Aug 5, 2026 (Skillselion catalog sync)
npx skills add https://github.com/microsoftdocs/agent-skills --skill azure-files

Add your badge

Show developers this skill is listed on Skillselion. Paste this into your README.

Listed on Skillselion
Installs124
repo stars682
Last updatedAugust 3, 2026
Repositorymicrosoftdocs/agent-skills

What it does

Helps with ai & agent building tasks during AI-assisted development.

Files

SKILL.mdMarkdownGitHub ↗

Azure Files Skill

This skill provides expert guidance for Azure Files. Covers best practices, decision making, 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

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_webpage with query string from=learn-agent-skill&accept=text/markdown. Returns Markdown.

Category Index

CategoryLinesDescription
Best PracticesL35-L50Best practices for Azure Files and Azure File Sync: DR/failover planning, server/drive replacement and recovery, safe deprovisioning, and performance tuning for SMB/NFS and VDI/FSLogix workloads.
Decision MakingL51-L71Guidance on planning Azure Files deployments, choosing tiers, redundancy, billing/cost models, and selecting/migrating to Azure Files or Azure File Sync from Windows/Linux and other storage.
Limits & QuotasL72-L79Scalability, performance, and quota limits for Azure Files and File Sync, including tiers, API throttling behavior, and FAQs on supported sizes, IOPS, and throughput.
SecurityL80-L108Securing Azure Files: identity/Kerberos/AD auth, NTFS/share permissions, encryption (TLS, CMK), network/perimeter, Linux/macOS clients, and on‑prem integration (firewalls, proxies, forests).
ConfigurationL109-L136Configuring Azure Files and Azure File Sync: networking, VPN and endpoints, performance and redundancy, cloud tiering, DFS integration, monitoring/metrics, and backup/soft delete settings.
Integrations & Coding PatternsL137-L159Patterns and code to build RAG apps over Azure Files using Haystack, LangChain, LlamaIndex, and vector DBs (Pinecone/Qdrant/Weaviate), plus .NET/Java/Python integration and auth.
DeploymentL160-L171Guides for migrating and syncing data to Azure Files/Azure File Sync from NAS, Linux, GlusterFS, SMB/NFS shares, and moving File Sync resources safely across scopes.

Best Practices

TopicURL
Implement disaster recovery best practices for Azure File Synchttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-disaster-recovery-best-practices
Modify Azure File Sync topology without data losshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-modify-sync-topology
Replace drives on Azure File Sync servers correctlyhttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-replace-drive
Replace Azure File Sync servers during lifecycle eventshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-replace-server
Deprovision Azure File Sync server endpoints safelyhttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-server-endpoint-delete
Recover Azure File Sync servers after failureshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-server-recovery
Plan Azure Files disaster recovery and failoverhttps://learn.microsoft.com/en-us/azure/storage/files/files-disaster-recovery
Handle large directories on NFS Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/nfs-large-directories
Tune NFS Azure file share performance at scalehttps://learn.microsoft.com/en-us/azure/storage/files/nfs-performance
Improve performance of premium SMB Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/smb-performance
Optimize Azure Files performance for your workloadshttps://learn.microsoft.com/en-us/azure/storage/files/understand-performance
Use Azure Files for virtual desktop and FSLogix profileshttps://learn.microsoft.com/en-us/azure/storage/files/virtual-desktop-workloads

Decision Making

TopicURL
Select optimal Azure File Sync cloud tiering policieshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-choose-cloud-tiering-policies
Plan and choose an Azure File Sync deploymenthttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-planning
Choose and configure Azure File Sync server endpointshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-server-endpoint-create
Choose and create Azure classic file shares by tierhttps://learn.microsoft.com/en-us/azure/storage/files/create-classic-file-share
Decide when to use Microsoft.FileShares file shareshttps://learn.microsoft.com/en-us/azure/storage/files/create-file-share
Estimate Azure Files costs across billing modelshttps://learn.microsoft.com/en-us/azure/storage/files/file-estimate-cost
Choose Azure Files redundancy options for durabilityhttps://learn.microsoft.com/en-us/azure/storage/files/files-redundancy
Reduce Azure Files costs using reservationshttps://learn.microsoft.com/en-us/azure/storage/files/files-reserve-capacity
Select redundancy for premium SSD Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/redundancy-premium-file-shares
Choose development approaches for Azure Files applicationshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-developer-overview
Migrate Linux servers to NFS Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-nfs
Choose migration approaches for SMB Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-overview
Choose between Azure Files and Azure NetApp Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-netapp-comparison
Plan Azure Files deployments and access optionshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-planning
Choose Azure Files billing model and manage costshttps://learn.microsoft.com/en-us/azure/storage/files/understanding-billing
Plan migration from Windows file servers to Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/windows-server-to-azure-files
Use zonal placement for SSD Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/zonal-placement

Limits & Quotas

TopicURL
Understand Azure File Sync scalability and performance targetshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-scale-targets
Review Azure File Sync API throttling limits and behaviorhttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-throttling
Azure Files and File Sync FAQ with limits and behaviorshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-faq
Azure Files scalability and performance limits by tierhttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-scale-targets

Security

TopicURL
Configure on-premises firewall and proxy for Azure File Synchttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-firewall-and-proxy
Use managed identities to secure Azure File Sync accesshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-managed-identities
Authorize Azure portal access to Azure file datahttps://learn.microsoft.com/en-us/azure/storage/files/authorize-data-operations-portal
Enable OAuth-based REST access to Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/authorize-oauth-rest
Change identity source for Azure Files SMB authenticationhttps://learn.microsoft.com/en-us/azure/storage/files/change-identity-source
Configure customer-managed encryption keys for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/customer-managed-keys
Enable TLS encryption in transit for NFS Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/encryption-in-transit-for-nfs-shares
Authenticate Azure Files SMB access with managed identitieshttps://learn.microsoft.com/en-us/azure/storage/files/files-managed-identities
Configure network security perimeter for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/files-network-security-perimeter
Secure and configure NFS file shares in Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/files-nfs-protocol
Disable insecure SMB1 on Linux for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/files-remove-smb1-linux
Configure Entra Kerberos auth for Azure Files on macOShttps://learn.microsoft.com/en-us/azure/storage/files/identity-kerberos-authentication-macos
Configure NFS root squash for Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/nfs-root-squash
Configure identity-based authentication for Azure Files over SMBhttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-active-directory-overview
Enable AD DS authentication for Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-ad-ds-enable
Configure on-prem AD DS authentication for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-ad-ds-overview
Rotate AD DS storage account identity passwordhttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-ad-ds-update-password
Assign share-level permissions for Azure Files SMBhttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-assign-share-level-permissions
Use Entra Domain Services auth with Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-auth-domain-services-enable
Configure cloud trust between AD DS and Entra ID for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-auth-hybrid-cloud-trust
Configure Entra Kerberos authentication for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-auth-hybrid-identities-enable
Configure Kerberos auth for Linux Azure Files clientshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-auth-linux-kerberos-enable
Configure NTFS ACL permissions for Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-configure-file-level-permissions
Configure Azure Files with multiple AD DS forestshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-identity-multiple-forests
Securely mount SMB Azure file shares on Linuxhttps://learn.microsoft.com/en-us/azure/storage/files/storage-how-to-use-files-linux

Configuration

TopicURL
Silently install Azure File Sync agent with custom settingshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-agent-silent-installation
Configure Azure File Sync cloud tiering date and space policieshttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-cloud-tiering-policy
Install and manage Azure File Sync agent on Arc servershttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-extension
Manage Azure File Sync cloud tiered files via PowerShellhttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-how-to-manage-tiered-files
Monitor Azure File Sync cloud tiering metrics and cachehttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-monitor-cloud-tiering
Configure and monitor Azure File Sync with Azure Monitorhttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-monitoring
Configure public and private endpoints for Azure File Synchttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-networking-endpoints
Configure networking for Azure File Sync caching servershttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-networking-overview
Reference metrics and logs for monitoring Azure File Synchttps://learn.microsoft.com/en-us/azure/storage/file-sync/monitor-file-sync-reference
Analyze Azure Files performance metrics with Azure Monitorhttps://learn.microsoft.com/en-us/azure/storage/files/analyze-files-metrics
Change redundancy configuration for Azure Files accountshttps://learn.microsoft.com/en-us/azure/storage/files/files-change-redundancy-configuration
Integrate DFS Namespaces with Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/files-manage-namespaces
Copy files between Azure file shares with toolshttps://learn.microsoft.com/en-us/azure/storage/files/migrate-files-between-shares
Configure size and performance of Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/modify-file-share
Configure Linux point-to-site VPN for Azure Files accesshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-configure-p2s-vpn-linux
Configure Windows P2S VPN access to Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-configure-p2s-vpn-windows
Set up site-to-site VPN connectivity for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-configure-s2s-vpn
Configure and mount NFS Azure file shares on Linuxhttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-how-to-mount-nfs-shares
Configure Azure Monitor metrics and logs for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-monitoring
Reference monitoring metrics and logs for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-monitoring-reference
Configure DNS forwarding to Azure Files private endpointshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-networking-dns
Configure public and private endpoints for Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-networking-endpoints
Configure networking and endpoints for Azure Files accesshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-networking-overview
Configure and use soft delete for Azure file shareshttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-prevent-file-share-deletion

Integrations & Coding Patterns

TopicURL
Integrate Haystack RAG pipelines with Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/orchestrations/haystack
Integrate LangChain RAG pipelines with Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/orchestrations/langchain
Integrate LlamaIndex RAG pipelines with Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/orchestrations/llamaindex
Authenticate and download Azure Files data for RAGhttps://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/setup
Implement Haystack + Pinecone RAG over Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/haystack-pinecone/tutorial-haystack-pinecone
Implement Haystack + Qdrant RAG over Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/haystack-qdrant/tutorial-haystack-qdrant
Implement Haystack + Weaviate RAG over Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/haystack-weaviate/tutorial-haystack-weaviate
Implement Azure Files RAG with LangChain and Pineconehttps://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/langchain-pinecone/tutorial-langchain-pinecone
Implement Azure Files RAG with LangChain and Qdranthttps://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/langchain-qdrant/tutorial-langchain-qdrant
Implement Azure Files RAG with LangChain and Weaviatehttps://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/langchain-weaviate/tutorial-langchain-weaviate
Implement Azure Files RAG with LlamaIndex and Pineconehttps://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/llamaindex-pinecone/tutorial-llamaindex-pinecone
Implement Azure Files RAG with LlamaIndex and Qdranthttps://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/llamaindex-qdrant/tutorial-llamaindex-qdrant
Implement Azure Files RAG with LlamaIndex and Weaviatehttps://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/tutorials/llamaindex-weaviate/tutorial-llamaindex-weaviate
Use Pinecone vector database with Azure Files RAGhttps://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/vector-databases/pinecone
Use Qdrant vector database with Azure Files RAGhttps://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/vector-databases/qdrant
Use Weaviate vector database with Azure Files RAGhttps://learn.microsoft.com/en-us/azure/storage/files/artificial-intelligence/retrieval-augmented-generation/open-source-frameworks/vector-databases/weaviate
Develop .NET applications that use Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-dotnet-how-to-use-files
Develop Java applications that use Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/storage-java-how-to-use-file-storage
Develop Python applications using Azure Files SDKshttps://learn.microsoft.com/en-us/azure/storage/files/storage-python-how-to-use-file-storage

Deployment

TopicURL
Move Azure File Sync resources across scopes safelyhttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-resource-move
Migrate data between Azure file shares with File Synchttps://learn.microsoft.com/en-us/azure/storage/file-sync/file-sync-share-to-share-migration
Migrate GlusterFS volumes to Azure Fileshttps://learn.microsoft.com/en-us/azure/storage/files/glusterfs-migration-guide
Migrate SMB/NFS shares to Azure Files via Storage Moverhttps://learn.microsoft.com/en-us/azure/storage/files/migrate-files-storage-mover
Migrate Linux servers to Azure File Sync hybridhttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-linux-hybrid
Migrate on-prem NAS to Azure Files with Data Boxhttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-nas-cloud-databox
Migrate NAS SMB shares to Azure File Sync hybridhttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-nas-hybrid
Migrate on-premises NAS to Azure File Sync using Data Boxhttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-nas-hybrid-databox
Migrate to SMB Azure file shares using Robocopyhttps://learn.microsoft.com/en-us/azure/storage/files/storage-files-migration-robocopy

Related skills

This week in AI coding

Five minutes, every Monday - the tools, releases and tactics for developers.

unsubscribe anytime.