azure/find-package-skill
**UTILITY SKILL** — Must be consulted before making any changes to packages under sdk/. Discovers and loads 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".
npx skills add https://github.com/Azure/azure-sdk-for-net --skill find-package-skill
Some SDK packages in this monorepo have package-specific skills — tribal
knowledge (architecture, data flows, type mappings, pitfalls) that prevents
common mistakes. Before modifying any SDK package, check whether a skill exists
for it using the steps below.
modifying, extract the package directory from it (e.g., a file at
sdk/search/search-documents/src/searchClient.ts belongs to the package at
sdk/search/search-documents/). If you only have a package name, search for a
matching directory under sdk/ (package directories are named after the
unscoped package name, e.g. @azure/search-documents →
sdk/search/search-documents/).
.github/skills/ directory inside the package directory. Forexample, check whether sdk/search/search-documents/.github/skills/ exists.
SKILL.md found under that directory. If areferences/ subdirectory exists next to a SKILL.md, read all files in it
too for additional context.
.github/skills/ directory exists for the package, nopackage-specific skill has been created yet — proceed normally.
Take azure/find-package-skill from the repository into ~/.claude/skills for personal
use, or into .claude/skills inside a project.
The agent identifies a skill by the name field in its header. Two skills with the
same name cannot sit side by side — one of them will be ignored.