CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

74

Quality

93%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

—

The risk profile of this skill

SKILL.md
Quality
Evals
Security

Quality

Content

100%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

An exemplary lean, instruction-only skill: a short motivating intro followed by an unambiguous four-step discovery workflow with concrete paths, a worked example, and fallback resolution. No padding, no gaps, and no unnecessary external file structure.

DimensionReasoningScore

Conciseness

The ~25-line body contains zero padding and no explanations of concepts Claude already knows — the brief framing sentence ('tribal knowledge (architecture, data flows, type mappings, pitfalls)') is the only context and it directly motivates the workflow. Every token earns its place, matching the 'lean and efficient' anchor.

5 / 5

Actionability

Each step is fully executable: exact directory names ('.github/skills/'), a concrete path-to-package example ('sdk/search/Azure.Search.Documents/src/SearchClient.cs' → 'sdk/search/Azure.Search.Documents/'), and a CODEOWNERS fallback when only a package name is known. Per the rubric's instruction-skill note, absence of code is not penalized when guidance is this concrete.

5 / 5

Workflow Clarity

The four steps are clearly sequenced with an explicit decision branch (skill directory exists → read all SKILL.md and references/; not exists → 'proceed normally'). This is a read-only discovery operation, so no validation/feedback loops are required, and the sequence with its branch handling is unambiguous — matching the simple-skill allowance for a 5.

5 / 5

Progressive Disclosure

The skill is under 50 lines with no bundle files (no references/, scripts/, or assets/ exist) and no need for external references; the two well-organized sections (intro + 'How to Discover Package Skills') satisfy the rubric's simple-skill exception for a top score.

5 / 5

Total

20

/

20

Passed

Description

82%Weight 40%Scale 1-5

Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.

A strong description in third-person voice with an explicit WHEN clause listing concrete trigger phrases and a clear, narrowly scoped domain. Its only weakness is modest action specificity — 'discovers and loads' summarizes rather than enumerating what the skill actually does.

DimensionReasoningScore

Specificity

The description names its domain ('packages under sdk/') and exactly two concrete actions ('Discovers and loads package-specific domain knowledge that prevents common mistakes'), which matches the anchor for 1-2 concrete actions. It does not list several specific actions, so anchor 4 does not fit.

3 / 5

Completeness

Both halves are explicit: the what ('Discovers and loads package-specific domain knowledge that prevents common mistakes') and the when ('Must be consulted before making any changes to packages under sdk/' plus 'WHEN: add feature to package; fix bug in package; …') with concrete trigger phrases — an exact match for the top anchor.

5 / 5

Trigger Term Quality

'add feature to package; fix bug in package; modify package code; regenerate from typespec; change client library' gives good natural keyword coverage a user would actually say. It is not comprehensive — synonyms like 'update', 'refactor', or 'work on the SDK' are missing — so it sits at anchor 4 rather than 5.

4 / 5

Distinctiveness Conflict Risk

The description is scoped to a clear niche — 'packages under sdk/' with 'typespec' and 'client library' triggers — making it unlikely to fire for unrelated skills and giving it minimal conflict risk, matching the top anchor.

5 / 5

Total

17

/

20

Passed

Validation

100%

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 16 / 16 Passed

Validation for skill structure

No warnings or errors.

Repository

Azure/azure-sdk-for-net

Path

.github/skills/find-package-skill/SKILL.md

Reviewed

Table of Contents

Is this your skill?

If you maintain this skill, you can claim it as your own. Once claimed, you can manage eval scenarios, bundle related skills, attach documentation or rules, and ensure cross-agent compatibility.