[JoshLove-msft]

Summary

Update the shared TypeSpec naming skill to consult the C# HTTP client emitter's automatic naming reference before reasoning about generated names or recommending @clientName overrides.

• Add the authoritative reference and distinguish built-in conversions from semantic ARM naming guidance.
• Avoid redundant overrides when applicable emitter defaults already produce the intended name; call out ordinary versus exact-name overrides, generator/version applicability, existing customizations, and released-contract precedence.
• Connect model naming guidance to the same reference without duplicating its conversion tables or broadening language/service coverage.

Documentation provenance

The reference is the comprehensive generator documentation introduced by microsoft/typespec#12370, which is still open at verification time. Following the user-directed relocation, the guide lives at packages/http-client-csharp/generator/docs/naming-conventions.md; all website changes were removed. The guide is linked from the emitter's .tspd/docs/usage.md and generated package README. There is no pending canonical website page or website deployment dependency.

This change links to the verified immutable generator documentation at commit 9457ed0a9874c04b5a72058b838a71923e5eb2c3. The pinned source is usable now and includes the reviewed DateTime, paging-metadata, and API-version naming corrections. The only pending source dependency is the open upstream documentation PR; this PR does not claim it has merged or shipped.

Distribution

.github/skills/azsdk-common-typespec-naming is the source of truth. There is no existing in-repository plugin mirror of this skill to update. The existing tools - sync-.github-skills pipeline distributes shared-skill changes to subscribed repositories; no downstream copies are edited manually.

Verification

• Focused strict Vally skill lint and eval-schema lint passed using repository-pinned Vally 0.19.0.
• Prettier check passed for all three modified Markdown files.
• Naming fixture and preservation tests passed: 15/15.
• All 12 local links/anchors across the skill's five Markdown files resolve; the relocated pinned upstream guide returns HTTP 200 and contains all three review corrections.
• Scoped git diff --check passed.

No SDK generation was run or claimed; this is a skill/reference-only update.

[azure-pipelines]

Azure Pipelines:
Successfully started running 1 pipeline(s).
71 pipeline(s) were filtered out due to trigger conditions.
There may be pipelines that require an authorized user to comment /azp run to run.

[Copilot]

🟢 Approval recommended

The focused documentation changes preserve compatibility and scope safeguards, with no unresolved findings.

No open issues 🎉

What changed in this PR

Updates the shared TypeSpec naming skill to consider C# emitter defaults before recommending naming overrides, while preserving compatibility and existing language/service scope.

Changes:

• Links to the pinned upstream naming reference and distinguishes automatic conversions from semantic ARM naming guidance.
• Clarifies override limits, generator applicability, and generated-name verification.
• Connects model naming guidance to the shared emitter reference without duplicating conversion tables.

File	Description
.github/​skills/​azsdk-common-typespec-naming/​SKILL.md	Requires considering emitter conversions before proposing overrides.
.github/​skills/​azsdk-common-typespec-naming/​references/​csharp-naming.md	Adds the pinned reference and applicability and override caveats.
.github/​skills/​azsdk-common-typespec-naming/​references/​csharp-model-naming.md	Connects model naming recommendations to emitter defaults.

_{Review effort: Balanced}

[JoshLove-msft]

Closing at the user's request. This focused naming-skill reference update is being moved directly to Azure/azure-rest-api-specs instead of proceeding through the tools-repository sync pipeline.

--generated by Copilot

[JoshLove-msft]

Moved directly to Azure/azure-rest-api-specs#47556 at the user's request. The replacement preserves the same focused naming guidance and pinned generator-documentation reference; this tools PR remains closed.

--generated by Copilot