CtrlK
BlogDocsLog inGet started
Tessl Logo

azure-ai-agents-persistent-java

Azure AI Agents Persistent SDK for Java. Low-level SDK for creating and managing AI agents with threads, messages, runs, and tools.

46

Quality

48%

Does it follow best practices?

Impact

No eval scenarios have been run

SecuritybySnyk

Passed

No known issues

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/antigravity-azure-ai-agents-persistent-java/SKILL.md
SKILL.md
Quality
Evals
Security

Quality

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 a specific technology domain (Azure AI Agents Persistent SDK for Java) and lists key SDK concepts, but it reads more like a library subtitle than a skill description. It critically lacks a 'Use when...' clause to guide skill selection, and the listed capabilities are SDK abstractions rather than concrete actions a user would request.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user needs to build or manage Azure AI agents in Java, work with the Azure AI Agent Service, or interact with the Persistent Agents SDK.'

Replace abstract SDK terms with concrete actions, e.g., 'Creates AI agents, manages conversation threads, sends and retrieves messages, initiates and monitors agent runs, and configures tools like code interpreter and file search.'

Include natural trigger terms users might say, such as 'Azure OpenAI agents', 'assistant API Java', 'agent service', or 'azure-ai-agents Java SDK'.

DimensionReasoningScore

Specificity

Names the domain (Azure AI Agents SDK for Java) and lists some concepts (threads, messages, runs, tools), but these are more like SDK abstractions than concrete user-facing actions. It doesn't describe specific actions like 'create agents', 'manage conversation threads', or 'execute tool calls'.

2 / 3

Completeness

Describes what the skill covers (low-level SDK for creating/managing AI agents with specific components) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per rubric guidelines, missing 'Use when' caps completeness at 2, and the 'what' is also only partially clear, so this scores a 1.

1 / 3

Trigger Term Quality

Includes relevant keywords like 'Azure', 'AI Agents', 'SDK', 'Java', 'threads', 'messages', 'runs', and 'tools', which are terms a developer might use. However, it misses common variations and natural phrases like 'assistant API', 'agent orchestration', 'Azure OpenAI agents', or 'persistent conversations'.

2 / 3

Distinctiveness Conflict Risk

The combination of 'Azure AI Agents', 'Persistent SDK', and 'Java' creates a fairly specific niche, but 'threads, messages, runs, and tools' are generic enough terms that could overlap with other agent-related or messaging skills. The 'low-level SDK' qualifier helps somewhat but could still conflict with other Azure or AI agent 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 skill provides a solid, actionable walkthrough of the Azure AI Agents Persistent SDK core workflow with executable Java code examples. Its main weaknesses are the lack of error recovery/validation feedback loops in the workflow (e.g., handling RequiresAction or Failed run statuses inline rather than just mentioning them in best practices), and some unnecessary boilerplate sections that consume tokens without adding value.

Suggestions

Expand step 4 (Run Agent) to include inline handling of RunStatus.REQUIRES_ACTION and RunStatus.FAILED with concrete code, creating a proper feedback loop rather than just mentioning these in best practices.

Remove the 'When to Use' and 'Limitations' boilerplate sections — they are generic filler that adds no skill-specific value.

Consider splitting advanced topics (tool definitions, file search, async patterns) into separate referenced files to improve progressive disclosure.

DimensionReasoningScore

Conciseness

Generally efficient with good code examples, but includes some unnecessary content like the 'Key Concepts' section explaining what the SDK does (Claude already knows), the 'When to Use' and 'Limitations' boilerplate sections add no value, and the 'Best Practices' section contains some obvious advice like 'use async for high concurrency'.

2 / 3

Actionability

Provides fully executable, copy-paste ready Java code for every step of the workflow including installation, authentication, agent creation, thread management, polling, message retrieval, cleanup, and error handling. All code snippets use real API classes and methods.

3 / 3

Workflow Clarity

The 6-step workflow is clearly sequenced and numbered, and includes polling logic. However, it lacks validation checkpoints — step 4 polls but doesn't handle failure/error statuses inline despite mentioning them in best practices. There's no feedback loop for when a run fails or requires action, which is important for this kind of multi-step agent orchestration.

2 / 3

Progressive Disclosure

Content is reasonably structured with clear sections, but everything is inline in a single file with no bundle files for advanced topics like tool usage, file search, or async patterns. The reference links point to external resources but there's no internal progressive disclosure structure for deeper SDK features.

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.

Validation10 / 11 Passed

Validation for skill structure

CriteriaDescriptionResult

frontmatter_unknown_keys

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

Warning

Total

10

/

11

Passed

Repository
boisenoise/skills-collections
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.