Dev & Engineering ✓ Microsoft · Official

Azure File Share TypeScript Skill

Guides coding agents through Azure SMB file-share operations in TypeScript.

48/ 100
Use with care

Useful, but reliability, evidence or controls still have material gaps.

See how it was scored ↓
Works as-is in
Codex · Claude Code
Stars
★ 2.7k
Last updated
3mo ago
License
MIT
azure-filesfile-sharetypescriptnodejs
+2smbazure-storage

What does this skill do, and when should you use it?

This skill supports JavaScript and TypeScript development with the @azure/storage-file-share SDK for Azure Files SMB shares, directories, and files. It covers client construction, connection strings, shared keys, Microsoft Entra credentials, and SAS access. The examples include uploads, downloads, copying, metadata, headers, ranges, snapshots, SAS generation, and RestError handling. It is a good fit for projects that need an agent to generate Azure File Share code, but execution still requires an Azure storage account and credentials.

Guides the agent to install @azure/storage-file-share and @azure/identity; construct ShareServiceClient, ShareClient, ShareDirectoryClient, and ShareFileClient; call Azure File Share APIs to create, list, delete, and configure shares; create and manage directories; upload or download strings, buffers, streams, and local files; copy and delete files; read or set properties, metadata, and HTTP headers; perform range writes, downloads, and clears; create or delete snapshots; generate file or share SAS tokens; and handle RestError status codes.

Good fit
  • A Node.js or TypeScript developer building a service that creates shares, directories, and files.
  • A backend team uploading Azure Files content from local files, buffers, or readable streams.
  • An application developer implementing partial file updates, range downloads, metadata, or HTTP headers.
  • A team connecting to Azure Storage with a connection string, shared key, Microsoft Entra credential, managed identity, or SAS.
  • An engineer creating snapshots before major changes and using idempotent create-or-delete patterns.

How do you install this skill?

Before you use it
  • Do not hard-code, commit, or log account keys, connection strings, or SAS tokens; prefer least-privilege managed identities and explicit confirmation for destructive operations.
  • Before adoption, verify the current @azure/storage-file-share API signatures, browser/Node.js limits, SAS generation pattern, and range-download call, and add end-to-end tests.
  • Mainland-China reachability is not documented; validate access to the required Azure services and documentation in the target environment.
Before you start
Your agent needs
  • Shell / CLI
  • Network access
  • Local filesystem
Install first
  • Node.js >=18.0.0
  • @azure/storage-file-share
  • @azure/identity

Install the collection with: npx skills add microsoft/skills. Select the required skill in the wizard; the collection is installed in the chosen agent directory, such as .github/skills/ for GitHub Copilot. Install the package dependencies in the project with: npm install @azure/storage-file-share @azure/identity.

Generic route: install into Claude Code manually (macOS / Linux)
tmp="$(mktemp -d)"
git clone --depth 1 https://github.com/microsoft/skills.git "$tmp"
mkdir -p ~/.claude/skills
cp -R "$tmp/.github/plugins/azure-sdk-typescript/skills/azure-storage-file-share-ts" ~/.claude/skills/
rm -rf "$tmp"

Generated from the source repository and skill path; it copies only this skill's folder. If the author's install steps above differ, follow those first. To scope it to one project, replace ~/.claude/skills with that project's .claude/skills.

How do you use this skill?

Try saying

Once installed, send your agent any of these to trigger it:

  • Create an Azure File Share, make a directory, and upload a file with @azure/storage-file-share and DefaultAzureCredential.

In an Agent Skills-compatible coding agent, use a request containing phrases such as “file share,” “@azure/storage-file-share,” “ShareServiceClient,” “ShareClient,” “SMB,” or “Azure Files.” For example: “Create an Azure File Share, make a directory, and upload a file with @azure/storage-file-share and DefaultAzureCredential.” Configure the Azure Storage environment variables, then ask the agent to generate code following the client, authentication, and operation examples. The source does not define a platform-specific invocation command or prompt format.

What are this skill's strengths and limitations?

Pros
  • Covers shares, directories, files, ranges, snapshots, SAS, and error handling.
  • Provides examples for connection strings, shared keys, Microsoft Entra credentials, and SAS.
  • Clearly identifies Node.js and browser differences and states the Node.js requirement.
  • Includes practical streaming and idempotent IfExists patterns.
Limitations
  • Several capabilities are Node.js-only, including shared keys, uploadFile, uploadStream, downloadToFile, downloadToBuffer, SAS generation, and DefaultAzureCredential.
  • Examples require an Azure Storage account, network access, and valid credentials; no local emulator or offline mode is documented.
  • The source provides no independent test coverage or test results for this individual skill.
  • The source specifies the package as current 12.x but does not identify a more precise package version.

How does this skill compare with similar options?

Side by side with related skills; every score comes from the same FSRS standard.

Skill FS score Stars Last updated License
Azure File Share TypeScript Skill this page ✓ Microsoft · Official 48 · Use with care ★ 2.7k 3mo ago MIT
Azure Blob Storage for TypeScript ✓ Microsoft · Official 51 · Use with care ★ 2.7k 3mo ago MIT
Microsoft 365 Agents SDK for TypeScript ✓ Microsoft · Official 48 · Use with care ★ 2.7k 3mo ago MIT
Azure Key Vault Secrets for TypeScript ✓ Microsoft · Official 44 · Not recommended ★ 2.7k 3mo ago MIT
Azure Key Vault Keys for TypeScript ✓ Microsoft · Official 38 · Not recommended ★ 2.7k 3mo ago MIT

How did FollowSkills review this skill?

FollowSkills review · FSRS-2.0
Use with care
48/ 100 5-point scale 2.4 / 5
1Trust14 / 25 · 2.8/5

The skill shows connection strings, account keys, SAS tokens, and token credentials, and includes delete, overwrite, copy, and local file I/O examples. It does not explain least privilege, user confirmation, sensitive-data non-logging, external data flows, failure recovery, or rollback, so points are deducted. No explicit red-line risk is evident.

2Reliability7 / 20 · 1.8/5

It covers common share, directory, and file operations and includes partial HTTP-status error handling. However, it provides no skill-specific tests, edge-case coverage, retry/idempotency guidance, or abnormal-input feedback. Under static calibration the score stays at or below 10, so points are deducted.

3Adaptability8 / 15 · 2.7/5

Trigger terms, the TypeScript/JavaScript scope, Node.js/browser differences, and major scenarios are reasonably clear. Non-fit cases, input/output contracts, compatibility boundaries, Chinese-language support, and mainland-China reachability are not specified, so points are deducted.

4Convention8 / 15 · 2.7/5

The file has YAML metadata, MIT licensing, author and 1.0.0 version information, and a readable structure covering installation, authentication, hierarchy, operations, and best practices. It lacks a changelog, explicit maintenance owner/update path, FAQ, pinned dependency versions, and systematic limitation disclosure, so points are deducted.

5Effectiveness7 / 15 · 2.3/5

The skill provides broadly useful snippets from authentication through shares, directories, files, ranges, snapshots, SAS, and error handling, making the core SDK reference task plausibly usable. There is no skill-specific executable validation, complete end-to-end sample, or comparative-benefit evidence, and some platform/API details require review; static calibration therefore caps this at 7.

6Verifiability4 / 10 · 2.0/5

The skill contains concrete code, version, and platform claims. The repository materials include generic CI, evaluation workflows, and harness tests, but they do not demonstrate coverage of this selected skill's key paths, and no third-party execution results or independent reproduction record is supplied; therefore the score remains below the static 5-point ceiling.

1 2 3 4 5 6

Open a dimension to read why it scored that way

Reviewed Jul 20, 2026 Reviewed revision 9ccaf7c3704a Review evidence[1][2][3][4][5][6][7][8][9][10]

Evidence confidence:Low — Mostly static review, author material or a limited demo; useful for discovery, not high-risk decisions.

See the full review method →

FAQ

Does this skill access my Azure Storage account directly?
No. It provides coding patterns. Actual access requires a storage account, network connectivity, and a connection string, key, SAS, or Microsoft Entra credential.
Can every example run in a browser?
No. The source marks shared-key credentials, uploadFile, uploadStream, downloadToFile, downloadToBuffer, SAS generation, and DefaultAzureCredential as Node.js-only.
Is it suitable for large files?
It provides large-file patterns. The skill recommends uploadStream or downloadToFile for files over 256 MB and also supports range upload, range download, and clear-range operations.
How can I avoid errors from repeated create or delete operations?
Use deleteIfExists, directoryClient.deleteIfExists, or exists() checks for idempotent flows. Share creation can still return status 409, which the skill demonstrates handling.

More skills from this repository

All from microsoft/agent-skills

Dev & Engineering ✓ Microsoft · Official

Azure Blob Storage for TypeScript

A practical guide for uploading, downloading, and managing Azure Blob Storage from TypeScript and JavaScript applications.

★ 2.7k FS 51 Use with care 3mo ago
Dev & Engineering ✓ Microsoft · Official

Microsoft 365 Agents SDK for TypeScript

Build TypeScript enterprise agents with routing, Express hosting, streaming responses, and Copilot Studio integration.

★ 2.7k FS 48 Use with care 3mo ago
Dev & Engineering ✓ Microsoft · Official

Azure Key Vault Secrets for TypeScript

Securely store and retrieve application secrets in Azure Key Vault while managing key lifecycles from Node.js.

★ 2.7k FS 44 Not recommended 3mo ago
Dev & Engineering ✓ Microsoft · Official

Azure Key Vault Keys for TypeScript

A practical TypeScript guide to creating, protecting, rotating, and using cryptographic keys in Azure Key Vault.

★ 2.7k FS 38 Not recommended 3mo ago
Dev & Engineering ✓ Microsoft · Official

Azure File Share for Python

Guides Python developers through secure Azure SMB share, directory, and file management.

★ 2.7k FS 50 Use with care 3mo ago
Dev & Engineering ✓ Microsoft · Official

Azure Storage Skill

Gives coding agents practical guidance and operations for Azure objects, files, queues, tables, and data lakes.

★ 2.7k FS 51 Use with care 3mo ago
Dev & Engineering ✓ Microsoft · Official

Azure Queue Storage TypeScript Skill

Build Azure Queue Storage workers that send, receive, inspect, and manage messages in TypeScript or JavaScript.

★ 2.7k FS 48 Use with care 3mo ago
Dev & Engineering ✓ Microsoft · Official

Azure Identity for TypeScript

Configure secure, flexible Microsoft Entra ID authentication for TypeScript Azure applications.

★ 2.7k FS 57 Use with care 3mo ago
Dev & Engineering ✓ Microsoft · Official

Azure Queue Storage for Rust

A focused guide for building secure Azure Queue Storage messaging workflows in Rust.

★ 2.7k FS 54 Use with care 3mo ago
Dev & Engineering ✓ Microsoft · Official

ADO Wiki Converter

Converts VitePress and GFM documentation into Azure DevOps Wiki-compatible files.

★ 2.7k FS 54 Use with care 3mo ago
Dev & Engineering ✓ Microsoft · Official

Azure Playwright Cloud Testing

Scale TypeScript Playwright tests on Azure-hosted browsers and publish results.

★ 2.7k FS 53 Use with care 3mo ago
Dev & Engineering ✓ Microsoft · Official

Azure Cosmos DB TypeScript Skill

Gives TypeScript and JavaScript coding agents practical Cosmos DB data-access patterns.

★ 2.7k FS 52 Use with care 3mo ago
Dev & Engineering ✓ Microsoft · Official

Azure Event Hubs TypeScript Skill

Build TypeScript event-streaming applications with batching, partition-aware consumers, checkpointing, and Azure identity authentication.

★ 2.7k FS 52 Use with care 3mo ago
Dev & Engineering ✓ Microsoft · Official

Azure AI Content Safety for TypeScript

Add text and image harm detection with customizable blocklists to TypeScript applications.

★ 2.7k FS 50 Use with care 3mo ago
Dev & Engineering ✓ Microsoft · Official

Azure Document Intelligence for TypeScript

Extract document text, tables, and structured fields in TypeScript applications.

★ 2.7k FS 50 Use with care 3mo ago
Dev & Engineering ✓ Microsoft · Official

Azure Translation for TypeScript

Build TypeScript applications for text translation, transliteration, language detection, and document translation.

★ 2.7k FS 50 Use with care 3mo ago
Dev & Engineering ✓ Microsoft · Official

Azure AI Search for TypeScript

Build TypeScript search apps with vector, hybrid, and semantic retrieval patterns.

★ 2.7k FS 50 Use with care 3mo ago
Dev & Engineering ✓ Microsoft · Official

Azure Service Bus for TypeScript

Build enterprise messaging workflows with Azure Service Bus.

★ 2.7k FS 50 Use with care 3mo ago
Dev & Engineering ✓ Microsoft · Official

Azure AI Projects for TypeScript

Practical TypeScript guidance for building Azure AI Foundry applications with project clients, agents, tools, and evaluations.

★ 2.7k FS 49 Use with care 3mo ago
Dev & Engineering ✓ Microsoft · Official

Azure PostgreSQL TypeScript Connector

A practical pg-based guide for secure, pooled Azure PostgreSQL access in Node.js and TypeScript.

★ 2.7k FS 49 Use with care 3mo ago

Related skills