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

Suggestions

Add an explicit 'Use when...' clause, e.g., 'Use when the user asks about building AI agents with Azure, creating persistent agent threads in .NET, or working with the Azure.AI.Projects SDK.'

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

Include common user-facing trigger terms and variations such as 'C#', 'Azure OpenAI agents', 'PersistentAgentsClient', 'assistant API', or 'Azure.AI.Projects' to improve matching.

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#', 'Azure OpenAI', 'assistant API', 'agent orchestration', or 'PersistentAgentsClient'.

2 / 3

Distinctiveness Conflict Risk

The mention of 'Azure AI Agents Persistent SDK for .NET' is fairly specific and narrows the domain, but 'AI agents with threads, messages, runs, and tools' could overlap with OpenAI Assistants API skills or other agent framework skills. The 'Persistent' qualifier and '.NET' help somewhat but the description could be more distinctive.

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, actionable SDK reference skill with excellent executable code examples covering the full range of Azure AI Agents Persistent operations. Its main weaknesses are the monolithic structure (everything in one file with no progressive disclosure to supporting files) and the lack of explicit validation/error-recovery steps in the multi-step workflows. Some minor verbosity in boilerplate sections and reference tables could be trimmed.

Suggestions

Add explicit validation checkpoints in the workflow — e.g., check run.Status for Failed/Cancelled after polling, verify vector store creation status before proceeding, and add a feedback loop pattern for retrying failed operations.

Split detailed tool-specific examples (function calling, file search, Bing grounding, AI Search) into separate bundle files and reference them from the main SKILL.md to improve progressive disclosure.

Remove the generic 'When to Use' and 'Limitations' boilerplate sections and trim the 'Best Practices' list to only non-obvious guidance specific to this SDK.

DimensionReasoningScore

Conciseness

The skill is mostly efficient with executable code examples, but includes some unnecessary sections like 'When to Use' and 'Limitations' boilerplate, the 'Related SDKs' table, and reference links that add little value. The Available Tools table and Key Types Reference could be trimmed. Some best practices (e.g., 'use async methods') are things Claude already knows.

2 / 3

Actionability

The skill provides fully executable, copy-paste ready C# code for every major operation: agent creation, threading, polling, streaming, function calling, file search, Bing grounding, AI Search, cleanup, and error handling. Code examples are complete with proper imports and realistic parameters.

3 / 3

Workflow Clarity

The core workflow is clearly numbered (1-9) with a logical sequence from agent creation through cleanup. However, there are no explicit validation checkpoints — for example, no guidance on checking if vector store creation succeeded before using it, no verification that file upload completed, and no feedback loops for handling failed runs beyond a brief mention in best practices.

2 / 3

Progressive Disclosure

The content is well-structured with clear headers and a logical progression from simple to complex, but it's a monolithic ~300-line file with no bundle files to offload detailed content. The function calling, file search, and Bing grounding sections could be split into separate reference files, with the main SKILL.md providing a concise overview and links.

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
sickn33/antigravity-awesome-skills
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.