Agent skill · software engineering · aiskillstore
azure-cosmos-ts
Azure Cosmos DB JavaScript/TypeScript SDK (@azure/cosmos) for data plane operations. Use for CRUD operations on documents, queries, bulk operations, and container management.
Why this skill is useful
Provides specific commands and patterns for CRUD operations on Azure Cosmos DB that the AI wouldn't reliably generate on its own.
What it needs
Requires @azure/cosmos, @azure/identity installed locally. Requires azure account access. About 5k tokens when loaded. Last updated 2026-08-07. 405 stars on the source repository.
What this skill does
@azure/cosmos (TypeScript/JavaScript) Data plane SDK for Azure Cosmos DB NoSQL API operations — CRUD on documents, queries, bulk operations. ⚠️ Data vs Management Plane - This SDK (@azure/cosmos): CRUD operations on documents, queries, stored procedures - Management SDK (@azure/arm-cosmosdb): Create accounts, databases, containers via ARM Installation Current Version: 4.9.0 Node.js: >= 20.0.0 Environment Variables Authentication AAD with DefaultAzureCredential (Recommended) Key-Based Authentication Resource Hierarchy Core Operations Database & Container Setup Create Document Read Document Update Document (Replace) Upsert Document Delete Document Patch Document (Partial Update) Queries Simple Query Parameterized Query (Recommended) Query with Pagination Cross-Partition Query Bulk Operations Execute Bulk Operations Partition Keys Simple Partition Key Hierarchical Partition Key (MultiHash) Error Handling Optimistic Concurrency (ETags) TypeScript Types Reference Best Practices 1. Use AAD authentication — Prefer DefaultAzureCredential over keys 2. Always use parameterized queries — Prevents injection, improves plan caching 3. Specify partition key — Avoid cross-partition queries when possible 4. Use bulk operations — For multiple writes, use executeBulkOperations 5. Handle 429 errors — Implement retry logic with exponential backoff 6. Use ETags for concurrency — Prevent lost updates in concurrent scenarios 7. Close client on shutdown — Call client.dispose() in cleanup Common Patterns Service Layer Pattern Related SDKs SDK Purpose Install ----- --------- --------- @azure/cosmos Data plane (this SDK) npm install @azure/cosmos @azure/arm-cosmosdb Management plane (ARM) npm install @azure/arm-cosmosdb @azure/identity Authentication npm install @azure/identity When to Use This skill is applicable to execute the workflow or actions described in the overview. Limitations Use this skill only when the task clearly matches the scope described above. …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aiskillstore/azure-cosmos-ts