# 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.

- Skill: `azure-azure-sdk-for-java/find-package-skill` (Agent Skill)
- Install (CLI): `npx skillmds@latest add azure-azure-sdk-for-java/find-package-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/azure-azure-sdk-for-java/find-package-skill/raw
- Safety review: pending
- Works with: Claude Code, Claude.ai, OpenAI Codex
- Category: Coding & Dev Tools
- Author: Azure (https://skillmd.com/u/azure-azure-sdk-for-java)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/azure-azure-sdk-for-java/find-package-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.

## How to Discover Package Skills

1. **Determine the package directory.** If you already know the file path you're
   modifying, extract the package directory from it (e.g., a file at
   `sdk/search/azure-search-documents/src/main/java/com/azure/search/documents/SearchClient.java`
   belongs to the package at `sdk/search/azure-search-documents/`). If you only
   have a package name, search for a matching directory under `sdk/` (package
   directories are named after the Maven artifactId, e.g.,
   `com.azure:azure-search-documents` → `sdk/search/azure-search-documents/`).

2. **Check for a `.github/skills/` directory** inside the package directory. For
   example, check whether `sdk/search/azure-search-documents/.github/skills/` exists.

3. **If it exists**, read every `SKILL.md` found under that directory. If a
   `references/` subdirectory exists next to a `SKILL.md`, read all files in it
   too for additional context.

4. **If no `.github/skills/` directory exists** for the package, no
   package-specific skill has been created yet — proceed normally.