# 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-js/find-package-skill` (Agent Skill)
- Install (CLI): `npx skillmds@latest add azure-azure-sdk-for-js/find-package-skill`
- Raw SKILL.md: https://api.skillmd.com/api/skills/azure-azure-sdk-for-js/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-js)
- Updated: 2026-09-10
- Page: https://skillmd.com/skills/azure-azure-sdk-for-js/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/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/`).

2. **Check for a `.github/skills/` directory** inside the package directory. For
   example, check whether `sdk/search/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.