find-package-skill

Discovers package-specific skill files within SDK package directories before code modifications.

2.6k|2.2k|Updated Dec 6, 2011
One-click install
npx skills add https://github.com/Azure/azure-sdk-for-java --skill find-package-skill
Or copy as Structured Prompt for Agent
Please help me install this Agent Skill.
Skill: find-package-skill
Source: https://github.com/Azure/azure-sdk-for-java/tree/main/.github/skills/find-package-skill
Command: npx skills add https://github.com/Azure/azure-sdk-for-java --skill find-package-skill

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve?

When working in a large monorepo like azure-sdk-for-java, package-specific tribal knowledge (architecture, data flows, type mappings, pitfalls) is easy to miss, leading to common mistakes when modifying SDK packages. This Skill ensures that domain knowledge is discovered and loaded before any package changes are made.

Core Features & Use Cases

  • Package Directory Resolution: Maps a file path or Maven artifactId (e.g., com.azure:azure-search-documents) to its package directory under sdk/.
  • Skill Discovery: Checks for a .github/skills/ directory inside the target package and reads every SKILL.md found there.
  • Reference Loading: Reads all files in any references/ subdirectory alongside discovered SKILL.md files for deeper context.
  • Use Case: Before fixing a bug in sdk/search/azure-search-documents, use this Skill to check whether package-specific guidance exists, so you avoid known pitfalls documented by the package maintainers.

Quick Start

Before modifying any package under sdk/, ask the AI to check whether a package-specific skill exists for that package and load its guidance.

Frequently Asked Questions about find-package-skill

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I find package-specific guidance before modifying an Azure SDK for Java package?

Locate the package directory under sdk/ (named after the Maven artifactId), then check for a .github/skills/ directory inside it. If it exists, read every SKILL.md and any files in adjacent references/ directories before making changes.

How do I map a Maven artifactId to a package directory in azure-sdk-for-java?

Package directories under sdk/ are named after the Maven artifactId. For example, com.azure:azure-search-documents maps to sdk/search/azure-search-documents/. You can also derive the directory from any file path you are editing.

What happens if a package has no .github/skills directory?

If no .github/skills/ directory exists inside the package directory, no package-specific skill has been created yet. You can proceed with your changes normally without loading additional guidance.

When should I check for a package-specific skill?

Check before any change to a package under sdk/, including adding features, fixing bugs, modifying package code, regenerating from TypeSpec, or changing a client library. The skill content prevents common package-specific mistakes.

What content does a package-specific skill provide?

A package-specific skill provides tribal knowledge such as architecture notes, data flows, type mappings, and pitfalls. If a references/ subdirectory exists next to the SKILL.md, its files supply additional in-depth context.