CLOUD DEVELOPMENT / Microsoft
Azure Key Vault Secrets SDK for TypeScript
Microsoft's TypeScript guide to @azure/keyvault-secrets for setting, reading, versioning, deleting, recovering and backing up Key Vault secrets; the same file also carries key and cryptography operations.
“Manage secrets using Azure Key Vault Secrets SDK for JavaScript (@azure/keyvault-secrets). Use when storing and retrieving application secrets or configuration values.”
01 / THE REASONING
Why this made the selection.
- It walks a secret's lifecycle: set it with enabled, expiresOn, contentType and tags, read the latest or a given version, list names and versions, soft-delete, purge and recover.
- It builds DefaultAzureCredential with requiredEnvVars: ["AZURE_TOKEN_CREDENTIALS"], leaves ManagedIdentityCredential as the commented production alternative, and handles the SecretNotFound error code explicitly.
- Its practice list asks for soft-delete on production vaults and expiration dates on both keys and secrets.
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-secrets-ts/SKILL.md (all 278 lines)
- .github/plugins/azure-sdk-typescript/skills/azure-keyvault-keys-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 list samples iterate listPropertiesOfSecrets and listPropertiesOfSecretVersions and print names and versions, not values.
- Backup and restore use backupSecret and restoreSecretBackup, with the comment that a backup can be restored to a different vault.
- Practice 6 says the SDKs are Node.js only; the browser is not supported.
- The error-handling sample treats error.code === "SecretNotFound" as a missing secret and rethrows any other error.
- The frontmatter declares license MIT, author Microsoft, version 1.0.0 and package @azure/keyvault-secrets. It declares no allowed-tools.
Not established by this review
- No secret was set, read, deleted, purged, recovered or backed up.
- No npm package was added to a project.
- Neither the azure-sdk-typescript plugin nor azure-keyvault-secrets-ts was installed, and its 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.
- 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-secrets-ts; it does not install that skill alone.
- The same README prints `/plugin install azure-sdk-typescript@skills`, which also brings in azure-keyvault-secrets-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-secrets @azure/identity`; the key and cryptography samples also need @azure/keyvault-keys, which that line leaves out. This review installed nothing.
- A Key Vault given by KEY_VAULT_URL or AZURE_KEYVAULT_NAME, and AZURE_TOKEN_CREDENTIALS for the DefaultAzureCredential sample.
- Node.js, since practice 6 says the SDKs do not run in a browser.
- Copilot CLI, where `/plugin install azure-sdk-typescript@skills` adds this secrets 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.
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-typescript/skills/azure-keyvault-secrets-ts/SKILL.md
Supports: name, upstreamDescription, summary, whySelected, bestFor, limitations, review.findings, install.prerequisites, access.permissions
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-typescript/README.md
Supports: install.sourceUrl, install.steps, limitations (install scope)
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/.github/plugins/azure-sdk-typescript/.claude-plugin/plugin.json
Supports: publisher, license (plugin licence field)
- Repository README ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/README.md
Supports: compatibility, install.steps (Copilot CLI plugin commands)
- Repository LICENSE ↗Checked
https://github.com/microsoft/skills/blob/fc164ba1d7a0c10377dbcc1c9ac07253b9329fdb/LICENSE
Supports: license
https://github.com/microsoft/skills/commit/ee33ce9d2b4372b0cfe58375bebbf0bd989e3ac9
Supports: limitations (last commit date)