Azure AI Projects SDK for Java. High-level SDK for Azure AI Foundry project management including connections, datasets, indexes, and evaluations.
46
48%
Does it follow best practices?
Impact
—
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/antigravity-azure-ai-projects-java/SKILL.mdQuality
Discovery
32%Based on the skill's description, can an agent find and select it at the right time? Clear, specific descriptions lead to better discovery.
The description identifies the technology domain and lists high-level capability areas but lacks concrete action verbs and, critically, has no 'Use when...' clause to guide skill selection. The terms used are somewhat specific to Azure AI Foundry but read more like a library subtitle than a skill selection guide.
Suggestions
Add an explicit 'Use when...' clause, e.g., 'Use when the user needs to work with Azure AI Foundry projects in Java, manage AI connections, create or query datasets/indexes, or run evaluations using the azure-ai-projects SDK.'
Replace category nouns with concrete action phrases, e.g., 'Create and manage Azure AI Foundry project connections, upload and query datasets, build search indexes, and run model evaluations.'
Include natural trigger terms users might say, such as 'azure-ai-projects', 'AI Foundry Java', 'Azure AI SDK', or specific package/class names.
| Dimension | Reasoning | Score |
|---|---|---|
Specificity | Names the domain (Azure AI Projects SDK for Java) and lists some actions/areas (project management, connections, datasets, indexes, evaluations), but these are more like categories than concrete actions (e.g., 'create connections', 'manage datasets', 'run evaluations' would be more specific). | 2 / 3 |
Completeness | Describes what the skill covers (Azure AI Projects SDK capabilities) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per rubric guidelines, a missing 'Use when...' clause should cap completeness at 2, and since the 'what' is also only moderately detailed, this scores a 1. | 1 / 3 |
Trigger Term Quality | Includes relevant keywords like 'Azure AI', 'SDK', 'Java', 'Azure AI Foundry', 'connections', 'datasets', 'indexes', 'evaluations', but misses common variations users might say such as 'azure-ai-projects', Maven artifact names, or specific class/method references. Coverage is decent but not comprehensive. | 2 / 3 |
Distinctiveness Conflict Risk | The combination of 'Azure AI Projects SDK' and 'Java' provides reasonable distinctiveness, but 'project management', 'connections', 'datasets', and 'evaluations' are generic enough terms that could overlap with other Azure SDK skills or general data management skills. | 2 / 3 |
Total | 7 / 12 Passed |
Implementation
64%Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.
This is a competent SDK reference skill with strong actionability through executable Java code examples covering the main operations. Its main weaknesses are the lack of a cohesive multi-step workflow connecting the operations, some boilerplate padding (When to Use, Limitations, Best Practices with obvious advice), and missed opportunity for progressive disclosure via bundle files for advanced topics like evaluations or dataset management.
Suggestions
Remove the generic 'When to Use' and 'Limitations' boilerplate sections, and trim 'Best Practices' to only non-obvious guidance specific to this SDK.
Add a cohesive end-to-end workflow example (e.g., authenticate → create dataset → create index → validate index exists) with explicit validation checkpoints.
Consider splitting detailed API examples for each sub-client into separate bundle files, keeping SKILL.md as a concise overview with references.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | Generally efficient with good code examples, but includes some unnecessary content like the 'When to Use' and 'Limitations' boilerplate sections that add no value, and the 'Best Practices' section contains advice Claude already knows (e.g., use environment variables, handle pagination). The reference links table is also of questionable value given Claude can't browse URLs. | 2 / 3 |
Actionability | Provides fully executable Java code examples for authentication, client creation, listing connections, listing indexes, creating indexes, and error handling. Code is copy-paste ready with proper imports and realistic usage patterns. | 3 / 3 |
Workflow Clarity | The skill presents individual operations clearly but lacks a cohesive workflow sequence. For an SDK reference skill, the client hierarchy and operations are well-organized, but there's no explicit workflow for common multi-step tasks (e.g., authenticate → create dataset → create index → run evaluation) and no validation checkpoints for operations that could fail. | 2 / 3 |
Progressive Disclosure | Content is reasonably structured with clear sections and a useful client hierarchy table, but everything is inline in a single file with no bundle files for detailed API references or advanced usage. The reference links point to external URLs rather than local bundle files, and some sections (like the full error handling example) could be split out for a cleaner overview. | 2 / 3 |
Total | 9 / 12 Passed |
Validation
90%Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.
Validation — 10 / 11 Passed
Validation for skill structure
| Criteria | Description | Result |
|---|---|---|
frontmatter_unknown_keys | Unknown frontmatter key(s) found; consider removing or moving to metadata | Warning |
Total | 10 / 11 Passed | |
8ac11ab
Table of Contents
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.