CtrlK
BlogDocsLog inGet started
Tessl Logo

azure-ai-agents-persistent-dotnet

Azure AI Agents Persistent SDK for .NET. 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

Advisory

Suggest reviewing before use

Optimize this skill with Tessl

npx tessl skill review --optimize ./skills/antigravity-azure-ai-agents-persistent-dotnet/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 .NET) and lists key SDK concepts, but it reads more like a library subtitle than a skill description. It lacks a 'Use when...' clause, concrete actions a user would request, and sufficient trigger term coverage to reliably distinguish it from related skills.

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user needs to create or manage Azure AI agents, conversation threads, or tool integrations using the .NET SDK.'

Replace abstract SDK terminology with concrete actions users would request, e.g., 'Creates AI agents, manages conversation threads, sends messages, executes runs, and configures tools using the Azure AI Agent Service .NET SDK.'

Include common keyword variations like 'C#', 'dotnet', 'Azure OpenAI', 'assistant', and 'agent orchestration' to improve trigger term coverage.

DimensionReasoningScore

Specificity

Names the domain (Azure AI Agents SDK for .NET) 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 'configure tool integrations'.

2 / 3

Completeness

Describes what the skill covers (Azure AI Agents SDK concepts) 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 clear, warranting a score of 1.

1 / 3

Trigger Term Quality

Includes relevant keywords like 'Azure', 'AI Agents', '.NET', 'SDK', 'threads', 'messages', 'runs', and 'tools' which users might mention. However, it misses common variations like 'C#', 'dotnet', 'assistant API', 'agent orchestration', or 'Azure OpenAI agents'.

2 / 3

Distinctiveness Conflict Risk

The combination of 'Azure AI Agents' and '.NET' provides some distinctiveness, but 'Persistent SDK' is ambiguous and the terms 'threads, messages, runs, tools' are generic enough to overlap with other Azure or AI agent-related 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 solid, highly actionable SDK reference skill with complete, executable C# code examples covering the full agent lifecycle. Its main weaknesses are the monolithic structure (all tool examples inline rather than progressively disclosed) and missing explicit validation/error recovery steps within the core workflow. Some minor verbosity in boilerplate sections and best practices that state obvious patterns could be trimmed.

Suggestions

Add explicit error handling and validation within the polling workflow (e.g., check for RunStatus.Failed/Cancelled with recovery guidance) rather than only mentioning it in best practices.

Split advanced tool configurations (function calling, file search, Bing grounding, AI Search) into separate referenced files to reduce the main skill's length and improve progressive disclosure.

Remove the generic 'When to Use' and 'Limitations' boilerplate sections that add no SDK-specific value, and trim best practices that state things Claude already knows (async usage, using statements).

DimensionReasoningScore

Conciseness

The skill is mostly efficient with executable code examples, but includes some unnecessary sections like the boilerplate 'When to Use' and 'Limitations' sections that add no value, and the reference tables at the bottom could be trimmed. The best practices section contains some advice Claude already knows (e.g., 'use async methods', 'use using statements'). Overall it's a long document (~300 lines) that could be tightened.

2 / 3

Actionability

The skill provides fully executable, copy-paste ready C# code for every major operation: authentication, agent creation, threading, polling, streaming, function calling, file search, Bing grounding, AI search, cleanup, and error handling. Each code block is complete and specific with real class names and method signatures.

3 / 3

Workflow Clarity

The core workflow is clearly numbered (steps 1-9) with a logical sequence from agent creation through cleanup. However, there are no explicit validation checkpoints — for example, after creating a run, there's no guidance on what to do if the run fails or enters an unexpected status. The polling loop checks for completion but doesn't handle the Failed/Cancelled cases inline despite the best practices section mentioning it.

2 / 3

Progressive Disclosure

The content is well-structured with clear headers and a logical progression from simple to complex, but it's monolithic — all tool examples (function calling, file search, Bing, AI Search) are inline rather than split into separate reference files. The reference tables at the end provide external links, but the main body could benefit from splitting advanced tool configurations into separate files.

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.