// Generate code from TypeSpec via tsp-client (update, sync, generate). Requires a tsp-location.yaml in the current working directory. Supports updating the commit hash before running.
Interactive wizard that walks service teams through creating a package-specific skill for their Azure SDK package. Scans the package, detects customization patterns, scaffolds a SKILL.md with references, validates with vally lint, and registers in find-package-skill. WHEN: create package skill; add service skill; bootstrap skill for package; new package skill; skill for my SDK package; write skill for search; write skill for cosmos.
**UTILITY SKILL** — Must be consulted before making any changes to packages under sdk/. Provides package-specific domain knowledge that prevents common mistakes. WHEN: add feature to package; fix bug in package; modify package code; regenerate from typespec; change client library.
Suppress generated Java classes that duplicate openai-java models, using @@alternateType in TypeSpec and manual serialization bridges. Use after dup-classes has identified actionable duplicates.
Verify whether generated Java classes duplicate openai-java models by comparing fields/types (names may differ). Use when checking for duplicate model coverage.
Interact with GitHub using the `gh` CLI. Use `gh issue`, `gh pr`, `gh run`, and `gh api` for issues, PRs, CI runs, and advanced queries.
Update CHANGELOG.md and README.md for an Azure SDK for Java package based on a GitHub PR. Use when the user wants to write or update release notes, changelogs, or readme docs from a PR reference.
| name | codegen |
| description | Generate code from TypeSpec via tsp-client (update, sync, generate). Requires a tsp-location.yaml in the current working directory. Supports updating the commit hash before running. |
Use this skill to run tsp-client workflows for projects that include a tsp-location.yaml file.
tsp-location.yaml.If the user provides a commit hash, update the commit: field in tsp-location.yaml before running tsp-client.
commit: line.commit: 6267b6...commit: <new_hash>tsp-client updatePull the latest codegen tooling or definitions (default action when the user is vague).
tsp-client update
tsp-client syncFetch/sync TypeSpec inputs for the project.
tsp-client sync
tsp-client generateGenerate code from TypeSpec inputs.
tsp-client generate
Keep the synced TypeSpec inputs:
tsp-client generate --save-inputs
tsp-location.yaml exists in the current directory. If not, stop and ask for the correct location.commit: value in tsp-location.yaml.tsp-client update.tsp-client sync.tsp-client generate (use --save-inputs only if the user asks to keep inputs).tsp-client generate.tsp-client update.TempTypeSpecFiles folder and the user wants code generation, run tsp-client generate (with --save-inputs if requested).tsp-location.yaml. Build a GitHub URL from repo: and directory: (and include the commit: as the ref), e.g.:
Azure/azure-rest-api-specs6267b6...specification/cognitiveservices/OpenAI.Inferencehttps://github.com/Azure/azure-rest-api-specs/tree/6267b6.../specification/cognitiveservices/OpenAI.Inference