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.

57

Quality

48%

Does it follow best practices?

Impact

Pending

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 the technology domain (Azure AI Agents SDK for Java) and lists key SDK concepts, but it reads more like a library subtitle than a skill description. It lacks a 'Use when...' clause, concrete action verbs describing what the skill enables, and natural trigger terms that developers would use when seeking help.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user needs to build, configure, or debug Azure AI agents in Java, or asks about the Azure AI Agent Service SDK.'

Replace abstract SDK terminology with concrete actions: 'Create and configure AI agents, manage conversation threads, send and retrieve messages, execute agent runs, and integrate tools like code interpreter and file search.'

Include natural trigger variations such as 'Azure OpenAI agents', 'assistant API Java', 'agent service', or 'azure-ai-agents' package name to improve keyword coverage.

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 tasks like 'create agents', 'manage conversation threads', or 'configure tool integrations'.

2 / 3

Completeness

It describes what the skill covers (low-level SDK for creating/managing AI agents) but completely lacks a 'Use when...' clause or any explicit trigger guidance for when Claude should select this skill. Per the rubric, a missing 'Use when...' clause caps completeness at 2, and the 'what' portion is also only moderately detailed, placing this at 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' provides some distinctiveness, but 'AI agents with threads, messages, runs, and tools' could overlap with other agent SDK skills (e.g., OpenAI Assistants API, other Azure AI skills). The 'Persistent' qualifier helps but isn't well explained.

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 with executable Java code for the core workflow. 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 don't add value. The content would benefit from handling failure states explicitly in the workflow and trimming generic filler.

Suggestions

Add explicit error handling and branching within the core workflow steps (e.g., after polling in step 4, show how to handle RunStatus.REQUIRES_ACTION and RunStatus.FAILED with concrete code, not just a best-practice bullet)

Remove the generic 'When to Use' and 'Limitations' boilerplate sections — they add no actionable information and waste tokens

Consider adding a reference to advanced topics (tool definitions, file search, function calling) either inline briefly or via separate referenced files to improve progressive disclosure

DimensionReasoningScore

Conciseness

Mostly efficient with executable code examples, but includes some unnecessary content like the 'Key Concepts' section explaining what the SDK does (Claude already knows from context), the generic 'When to Use' and 'Limitations' boilerplate sections, and the client hierarchy table that adds little value. The 'Best Practices' section mixes obvious advice with useful tips.

2 / 3

Actionability

Provides fully executable, copy-paste ready Java code for every step of the workflow — from dependency installation through authentication, agent creation, thread management, polling, response retrieval, cleanup, and error handling. All code is concrete with real imports and method calls.

3 / 3

Workflow Clarity

The 6-step core workflow is clearly sequenced and numbered, with polling logic included. However, there are no validation checkpoints or error recovery feedback loops — step 4 polls but doesn't handle failure states inline (only mentioned abstractly in best practices), and there's no guidance on what to do if a run fails or requires action, which are destructive gaps for an agent orchestration workflow.

2 / 3

Progressive Disclosure

Content is reasonably structured with clear sections and a reference links table pointing to external resources. However, all content is inline in a single file — the tool definitions, file search, and other advanced features that the SDK supports are not referenced or organized into separate files, making this a somewhat monolithic presentation for what could be a richer skill.

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.