CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-ai-projects-java

Azure AI Projects SDK for Java. High-level SDK for Azure AI Foundry project management including connections, datasets, indexes, and evaluations.

77

1.59x
Quality

73%

Does it follow best practices?

Impact

97%

1.59x

Average score across 3 eval scenarios

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/azure-ai-projects-java/SKILL.md

The canonical home for this skill is azure-ai-projects-java in sickn33/agentic-awesome-skills

SKILL.md
Quality
Evals
Security

Quality

Content

75%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.

A well-structured, code-first reference for the Java SDK: setup through operations is executable and logically ordered, with honest external links for deeper material. Weaknesses are minor — a filler 'When to Use' section, one thin/vague snippet (getOpenAIClient), and clients listed in the table but never demonstrated.

DimensionReasoningScore

Conciseness

The body is code-forward with almost no explanation of concepts Claude already knows — sections jump straight to Maven coordinates, env vars, and executable Java. Minor trimmable overhead exists: the circular filler 'This skill is applicable to execute the workflow or actions described in the overview' and the time-sensitive '1.0.0-beta.1' version pin (guideline flags version numbers outside a deprecated section). This matches anchor 4 (efficient, minor instances to trim) rather than 5.

4 / 5

Actionability

Most guidance is concrete and executable: a copy-paste Maven dependency, env var setup, a complete client-builder snippet, and working examples for listing connections, listing indexes, and creating an index. Minor gaps keep it below anchor 5: the OpenAI evaluation snippet is thin ('evaluationsClient.getOpenAIClient(); // Use OpenAI evaluation APIs directly') and the error-handling example references an undefined 'version' variable.

4 / 5

Workflow Clarity

The reference-style content is logically sequenced — Installation → Environment Variables → Authentication → Client Hierarchy → Core Operations → Best Practices → Error Handling — giving a clear progression from setup to use. It lacks explicit validation checkpoints (e.g., verifying auth or a successful list call before proceeding), placing it at anchor 4 rather than 5; no destructive or batch operations are present that would impose the cap at 3.

4 / 5

Progressive Disclosure

Well-organized sections with clear headers, a client-hierarchy table, and an explicit Reference Links section pointing to product docs, API reference, source, and samples — all one level deep, no nested references. It scores 4 rather than 5 because the whole SDK surface (all seven sub-clients and every operation) is inlined in SKILL.md with no per-area detail files; sub-clients like SchedulesClient and EvaluatorsClient are mentioned but never shown.

4 / 5

Total

16

/

20

Passed

Description

61%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.

The description clearly and specifically states what the skill covers, with good product-name keywords and a distinct niche. Its main weakness is the complete absence of any 'when to use' trigger clause and the reliance on domain nouns rather than concrete actions.

Suggestions

Add a 'Use when...' clause, e.g., 'Use when writing Java code against Azure AI Foundry, managing AI project connections/datasets/indexes, or running evaluations with the azure-ai-projects Maven artifact.'

Convert domain nouns into concrete actions, e.g., 'enumerate connections, upload datasets, create search indexes, and run model evaluations.'

Include trigger variations users might actually type, such as 'AI Foundry Java SDK' or the Maven coordinates 'com.azure:azure-ai-projects'.

DimensionReasoningScore

Specificity

The description names the domain ('Azure AI Projects SDK for Java', 'Azure AI Foundry project management') and enumerates four concrete capability areas ('connections, datasets, indexes, and evaluations'), but these are noun objects rather than actions — no verbs like 'list', 'upload', or 'run' appear. It sits above anchor 2 ('names the domain but actions are minimal') because four specific areas are listed, but below anchor 4 ('lists several specific actions') because no concrete actions are stated.

3 / 5

Completeness

The 'what' is clearly answered ('High-level SDK for Azure AI Foundry project management including connections, datasets, indexes, and evaluations') but there is no 'Use when...' clause or any explicit trigger guidance, capping completeness at 3 per the rubric guideline. It is above anchor 2 because the 'what' is specific and clear, not vague.

3 / 5

Trigger Term Quality

Good keyword coverage: 'Azure AI Projects SDK', 'Java', 'Azure AI Foundry', 'project management', plus domain objects 'connections, datasets, indexes, evaluations' — a user needing this skill would naturally say these terms. It falls short of anchor 5 because common variations like 'AI Foundry Java', 'Maven', or 'Azure SDK for Java' are missing.

4 / 5

Distinctiveness Conflict Risk

'Azure AI Projects SDK for Java' is a clear, specific niche unlikely to trigger for unrelated skills. Minor overlap risk exists with closely related skills (e.g., a Python counterpart of the same SDK or generic Azure SDK skills), matching anchor 4 rather than anchor 5, whose example includes explicit distinct trigger phrases this description lacks.

4 / 5

Total

14

/

20

Passed

Validation

93%

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

Validation — 15 / 16 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

Unknown frontmatter key(s) found; consider removing or moving to metadata

Warning

Total

15

/

16

Passed

Repository

administrakt0r/AI-Agents-Safe-Coding-Skills

Path

plugins/AI-Agents-Safe-Coding-Skills/skills/azure-ai-projects-java/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.