Azure AI Agents Persistent SDK for Java. Low-level SDK for creating and managing AI agents with threads, messages, runs, and tools.
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-agents-persistent-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 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'.
| Dimension | Reasoning | Score |
|---|---|---|
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.
| Dimension | Reasoning | Score |
|---|---|---|
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.
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.