← Explore all skills

CLOUD DEVELOPMENT / Microsoft

Azure Key Vault Keys SDK for TypeScript

Microsoft's TypeScript guide to @azure/keyvault-keys for creating, rotating and deleting Key Vault keys and for encrypt, sign and wrap operations through CryptographyClient; the same file also carries secret operations.

“Manage cryptographic keys using Azure Key Vault Keys SDK for JavaScript (@azure/keyvault-keys). Use when creating, encrypting/decrypting, signing, or rotating keys.”

01 / THE REASONING

Why this made the selection.

  • It creates keys four ways (generic RSA, RSA with keySize 2048, EC on P-256, and with keyOps, tags and an expiry), rotates a key on demand and sets a policy that rotates P30D before a P90D expiry.
  • Its CryptographyClient samples encrypt and decrypt with RSA-OAEP, sign and verify a SHA-256 digest with RS256, and wrap and unwrap key material.
  • It shows key backup and restore, noting that a backup can be restored to a different vault, and practice 5 says to grant only the key operations needed.

02 / THE REVIEW RECORD

What we actually inspected.

Source review has boundaries.
A clear record is more useful than a “safe” badge.

Material inspected

  • .github/plugins/azure-sdk-typescript/skills/azure-keyvault-keys-ts/SKILL.md (all 278 lines)
  • .github/plugins/azure-sdk-typescript/skills/azure-keyvault-secrets-ts/SKILL.md (compared line by line)
  • .github/plugins/azure-sdk-typescript/README.md
  • .github/plugins/azure-sdk-typescript/.claude-plugin/plugin.json
  • README.md
  • LICENSE

Our findings

  • The Authentication sample builds DefaultAzureCredential with requiredEnvVars: ["AZURE_TOKEN_CREDENTIALS"] and leaves ManagedIdentityCredential as a commented production alternative.
  • The vault URL is built from AZURE_KEYVAULT_NAME, although KEY_VAULT_URL is listed first in the environment block.
  • Practice 2 says soft-delete is required for production vaults.
  • A CryptographyClient can be built from the key object or from key.id.
  • The frontmatter declares license MIT, author Microsoft, version 1.0.0 and package @azure/keyvault-keys. It declares no allowed-tools.

Not established by this review

  • No key was created, rotated, deleted, purged or used to encrypt, sign or wrap.
  • @azure/keyvault-keys and @azure/identity were not installed from npm.
  • Neither the azure-sdk-typescript plugin nor azure-keyvault-keys-ts was installed; its two reference files were not read.
  • Not executed: it was not installed or run.

The review applies to the material and revision named here. A newer upstream release can change its behavior.

03 / PUT IT TO WORK

Add a skill to your workflow.

Upstream setup instructions ↗
  1. The azure-sdk-typescript plugin README prints `npx skills add microsoft/skills --skill azure-sdk-typescript` under Install. It installs the whole azure-sdk-typescript plugin, whose skill table lists azure-keyvault-keys-ts; it does not install that skill alone.
  2. The same README prints `/plugin install azure-sdk-typescript@skills`, which also brings in azure-keyvault-keys-ts together with every other skill in the plugin. The repository README runs plugin commands inside Copilot CLI after `/plugin marketplace add microsoft/skills`.

Before you start

  • The skill prints `npm install @azure/keyvault-keys @azure/identity`; its SecretClient samples also need @azure/keyvault-secrets, which that line does not add. This review installed nothing.
  • A Key Vault named by KEY_VAULT_URL or AZURE_KEYVAULT_NAME, with AZURE_TOKEN_CREDENTIALS set for the DefaultAzureCredential sample.
  • A Node.js runtime: practice 6 rules out the browser.
  • Copilot CLI, where `/plugin install azure-sdk-typescript@skills` adds this keys skill with the rest of the plugin.

04 / FOLLOW THE EVIDENCE

The source trail.

Our notes are separate from the original resource.
Check upstream before adopting a new version.

  1. https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-typescript/skills/azure-keyvault-keys-ts/SKILL.md

    Supports: name, upstreamDescription, summary, whySelected, bestFor, limitations, review.findings, install.prerequisites, access.permissions

  2. https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-typescript/README.md

    Supports: install.sourceUrl, install.steps, limitations (install scope)

  3. https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-typescript/.claude-plugin/plugin.json

    Supports: publisher, license (plugin licence field)

  4. Repository README ↗Checked

    https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md

    Supports: compatibility, install.steps (Copilot CLI plugin commands)

  5. Repository LICENSE ↗Checked

    https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE

    Supports: license

  6. https://github.com/microsoft/skills/commit/ee33ce9d2b4372b0cfe58375bebbf0bd989e3ac9

    Supports: limitations (last commit date)

Evidence & Ask