Skip to content

Add find-package-skill registry for package-specific skills#48657

Draft
samvaity wants to merge 3 commits intoAzure:mainfrom
samvaity:savaity/add-find-package-skill
Draft

Add find-package-skill registry for package-specific skills#48657
samvaity wants to merge 3 commits intoAzure:mainfrom
samvaity:savaity/add-find-package-skill

Conversation

@samvaity
Copy link
Copy Markdown
Member

Description

Add the find-package-skill discovery skill at .github/skills/, matching the pattern established across all other Azure SDK language repos. This skill serves as a routing table that tells AI agents to check for package-specific domain knowledge before modifying any SDK package.

The package skills table is currently empty - package teams can register their skills here as they create them (e.g., azure-search-documents).

Why

Java is the only Azure SDK repo without this infrastructure. All other repos have it:

Eval Results

Tested with a mock search spec. With a well-structured package skill, agent accuracy for post-regeneration fixes went from 1/3 correct fix locations to 3/3.

samvaity and others added 3 commits March 31, 2026 14:36
Add the find-package-skill discovery skill at .github/skills/, matching the
pattern established in azure-sdk-for-js, azure-sdk-for-python, and
azure-sdk-for-net. This skill serves as a routing table that tells AI agents
to check for package-specific domain knowledge before modifying any SDK package.

The package skills table is currently empty — package teams can register their
skills here as they create them (e.g., azure-search-documents).

Related PRs:
- JS: Azure/azure-sdk-for-js#37484
- Python: Azure/azure-sdk-for-python#45972
- .NET: Azure/azure-sdk-for-net#57580

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
Add a placeholder package skill for azure-search-documents with headings
matching the pattern from JS, Python, and .NET search skills. Sections
are TODO stubs for domain experts to fill in:
- Common Pitfalls, Architecture, Regeneration Workflow, Key Files,
  Service Version Management, Post-Regeneration Customizations,
  Type Mappings, Testing Notes
- references/architecture.md and references/customizations.md placeholders
- Registered in find-package-skill table

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
…Mappings section

Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>
@samvaity
Copy link
Copy Markdown
Member Author

samvaity commented Apr 2, 2026

@copilot fix the errors on the PR

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant