azure/create-crate
.github/skills/create-crate/SKILL.md
Create a new Azure SDK crate from a TypeSpec specification.
$ install --global
skillsauthnpx skillsauth add azure/azure-sdk-for-rust create-crateInstall this skill globally with one command. Works with Claude Code, Cursor, and Windsurf.
Security Scan Results
3 of 9 scanners reported clean
Some scanners were skipped, did not run, or reported a non-clean status. Review each row below.
3
Scanners Passed
9
Scanners in report
Clean
TrivyContainer and dependency vulnerability scanner
95%
Clean
SemgrepStatic code analysis for vulnerabilities
95%
Clean
mcp-scan (Snyk)Model Context Protocol security validation
95%
Skipped
Snyk (dep)Open source security scanning
50%
Skipped
Socket.devSupply chain security analysis
50%
Skipped
VirusTotalMulti-engine malware detection
50%
Skipped
CrowdStrikeAdvanced threat intelligence
50%
Skipped
OSV-ScannerOpen Source Vulnerability database check
50%
Skipped
OWASP Dep-Check
50%
Last scanned: Apr 3, 2026, 4:23 PM210.6s1 file scanned
SKILL.md
- name:
- create-crate
- description:
- Create a new Azure SDK crate from a TypeSpec specification.
Creating a New Crate
All new service crates must be generated from TypeSpec specifications in Azure/azure-rest-api-specs. Do not hand-write client libraries from scratch.
-
Install tsp-client
- Follow
eng/common/tsp-client/README.mdto install dependencies - Run
npm cifromeng/common/tsp-client/ - Use
npm exec --prefix eng/common/tsp-client -- tsp-client <command>to invoke it from the repository root
- Follow
-
Find the TypeSpec spec
- Look for a
tspconfig.yamlunderspecification/<service>/in azure-rest-api-specs - Check the
tspconfig.yamlfor@azure-tools/typespec-rustemitter configuration - If no emitter configuration exists, stop and report an error indicating that the TypeSpec specification in Azure/azure-rest-api-specs must be updated before generating the client
- Look for a
-
Initialize the crate
- Run
npm exec --prefix eng/common/tsp-client -- tsp-client init --tsp-config <url>from the repository root <url>is the GitHub URL to thetspconfig.yaml- Always use a specific commit SHA in the URL — never a branch or tag, which can move
- Example:
https://github.com/Azure/azure-rest-api-specs/blob/<commit-sha>/specification/<service>/<rp>/tspconfig.yaml
- Run
-
Generate the client
- Use the
azsdk_package_generate_codeMCP tool, or - Run
npm exec --prefix eng/common/tsp-client -- tsp-client updatefrom the crate directory
- Use the
-
Add hand-written wrappers
- Create
clients.rs(or similar) for custom client constructors, authentication setup, and convenience methods - Build on top of the generated code in
src/generated/
- Create
-
Register the crate
- Add the new crate to the workspace
memberslist in the rootCargo.toml
- Add the new crate to the workspace
-
Add tests, examples, and documentation
- Write unit tests and integration tests (using
#[recorded::test]) - Add examples, a
README.md, and aCHANGELOG.md
- Write unit tests and integration tests (using
Related Skills
azure/cosmos-design-struct
development
VerifiedTrustedCommunity
Enforce consistent struct design conventions across sdk/cosmos crates. Validates visibility modifiers, field privacy, #[non_exhaustive] usage, and construction API patterns (`Default`/`new` with `with_*` setters, or optional separate builders with `builder()`/`build()`), and construction correctness on public structs. Can auto-fix violations or report them as errors.
870SKILL.mdUpdated Apr 3, 2026
azure/cosmos-pre-commit-validation
development
VerifiedTrustedCommunity
Run pre-commit checks for a specific set of crates. Use this when validating changes under sdk/cosmos before committing or during code review.
867SKILL.mdUpdated Apr 3, 2026
azure/update-emitter
tools
VerifiedTrustedCommunity
Update the TypeSpec emitter for Rust and optionally regenerate all clients
867SKILL.mdUpdated Apr 3, 2026
azure/lint-markdown
tools
VerifiedTrustedCommunity
Check and fix formatting and other issues in markdown files using markdownlint-cli2.
867SKILL.mdUpdated Apr 3, 2026