added the create-package-skill.

[xiangyan99]

Description

added the create-package-skill and updated search skill based on it.

Please add an informative description that covers that changes made by the pull request and link all relevant issues.

If an SDK is being regenerated based on a new API spec, a link to the pull request containing these API spec changes should be included above.

All SDK Contribution checklist:

• The pull request does not introduce [breaking changes]
• CHANGELOG is updated for new features, bug fixes or other significant changes.
• I have read the contribution guidelines.

General Guidelines and Best Practices

• Title of the pull request is clear and informative.
• There are a small number of commits, each of which have an informative message. This means that previously merged commits do not appear in the history of the PR. For more information on cleaning up the commits in your PR, see this page.

Testing Guidelines

• Pull request includes test coverage for the included changes.

[Copilot]

Pull request overview

Adds a new “create-package-skill” wizard under .github/skills/ to help service teams scaffold/validate/register package-specific skills, and updates the existing azure-search-documents skill + customization inventory to align with the current customization surface.

Changes:

• Introduces .github/skills/create-package-skill/ (SKILL.md + phased wizard docs + reference templates/tools).
• Refreshes azure-search-documents skill steps (import smoke tests, workflow steps, customization patterns) to match current package structure.
• Expands/rewrites azure-search-documents references/customizations.md into a more complete per-_patch.py inventory with __all__ and post-regen checks.

Reviewed changes

Copilot reviewed 10 out of 10 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
sdk/search/azure-search-documents/.github/skills/azure-search-documents/references/customizations.md	Updates the customization inventory for all non-empty _patch.py files and post-regeneration verification checklist.
sdk/search/azure-search-documents/.github/skills/azure-search-documents/SKILL.md	Updates the post-regeneration workflow and customization patterns reference for azure-search-documents.
.github/skills/create-package-skill/SKILL.md	Adds the top-level wizard skill and links to each phase + references.
.github/skills/create-package-skill/phases/00-scan-package.md	Adds Phase 0 instructions for scanning a package’s structure/customizations/tests/docs.
.github/skills/create-package-skill/phases/01-scaffold-skill.md	Adds Phase 1 instructions to scaffold a package SKILL.md (Option A/B).
.github/skills/create-package-skill/phases/02-generate-references.md	Adds Phase 2 instructions for generating references/customizations.md (+ optional architecture).
.github/skills/create-package-skill/phases/03-validate.md	Adds Phase 3 instructions for structural validation (vally lint) + token budget checks.
.github/skills/create-package-skill/phases/04-register.md	Adds Phase 4 instructions to register the new package skill in find-package-skill.
.github/skills/create-package-skill/references/skill-template.md	Adds a reusable SKILL.md template + required content rules for package skills.
.github/skills/create-package-skill/references/validation-tools.md	Adds reference documentation for the proposed “vally lint” validation workflow.

[efrainretana]

saw this PR touched some of the search skills before it got reverted, but left me with a question - I see this adds a create-skill agent skill for the python repo. Are there any plans for creating similar skills to this for other langs?

[xiangyan99]

saw this PR touched some of the search skills before it got reverted, but left me with a question - I see this adds a create-skill agent skill for the python repo. Are there any plans for creating similar skills to this for other langs?

Yes. For any services that need customization, this skill can help to bootstrap the creation of the skill and we will have it for all languages.

[efrainretana]

saw this PR touched some of the search skills before it got reverted, but left me with a question - I see this adds a create-skill agent skill for the python repo. Are there any plans for creating similar skills to this for other langs?

Yes. For any services that need customization, this skill can help to bootstrap the creation of the skill and we will have it for all languages.

Do you have a rough timeline when other langs like .NET, JS, and Java might have access to this new skill?

[xiangyan99]

saw this PR touched some of the search skills before it got reverted, but left me with a question - I see this adds a create-skill agent skill for the python repo. Are there any plans for creating similar skills to this for other langs?

Yes. For any services that need customization, this skill can help to bootstrap the creation of the skill and we will have it for all languages.

Do you have a rough timeline when other langs like .NET, JS, and Java might have access to this new skill?

The Java one has been merged: https://github.com/Azure/azure-sdk-for-java/tree/main/.github/skills/create-package-skill

The JS has a PR for it: https://github.com/Azure/azure-sdk-for-js/pull/38284/changes

.NET may need more time.