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.

2.40x

Quality

65%

Does it follow best practices?

Impact

96%

2.40x

Average score across 3 eval scenarios

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills/skills/azure-ai-agents-persistent-dotnet/SKILL.md

The canonical home for this skill is azure-ai-agents-persistent-dotnet in sickn33/agentic-awesome-skills

Quality

Content

65%Weight 40%Scale 1-5

Reviews the quality of instructions and guidance provided to agents. Good implementation is clear, handles edge cases, and produces reliable results.

The content is highly actionable and well-organized with broad executable coverage, but it suffers from a destructive cleanup step lacking validation and from monolithic inlining of reference material that should be split into separate files.

Suggestions

Add a validation/verification checkpoint before the cleanup section (e.g. confirm runs are completed and IDs exist before deletion) to satisfy the destructive-operation feedback-loop requirement.

Move the Available Tools, Streaming Update Types, Key Types, and Reference Links tables into separate reference files linked one level deep from SKILL.md to improve progressive disclosure.

Define or stub the placeholder helpers (ExecuteFunction, searchConnectionId) so every code example is genuinely copy-paste runnable.

Dimension	Reasoning	Score
Conciseness	The body is a lean, code-first reference that mostly assumes competence, but inline time-sensitive version numbers ('Stable v1.1.0, Preview v1.2.0-beta.8') and some reference-table bulk keep it just short of fully efficient.	4 / 5
Actionability	Provides extensive copy-paste-ready C# across nine workflows covering common cases, but a few examples rely on undefined placeholders (ExecuteFunction, searchConnectionId), creating minor gaps.	4 / 5
Workflow Clarity	The 1–9 sequence is clear with status-check polling loops, but the destructive cleanup workflow deletes threads, agents, vector stores, and files without any validation checkpoint, capping this at 3 per the rubric.	3 / 5
Progressive Disclosure	No bundle files exist and the entire ~350-line reference is inlined in SKILL.md; section headers provide structure, but content that belongs in separate files (tools, types, links tables) is all inline.	3 / 5
	Total	14 / 20 Passed

Description

66%Weight 40%Scale 1-5

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 is specific and clearly niche-targeted, but it lacks any 'when to use' trigger guidance, which caps its completeness. Adding an explicit Use-when clause would meaningfully raise the score.

Suggestions

Append a 'Use when...' clause with concrete trigger phrases, e.g. 'Use when building .NET apps that create and manage persistent Azure AI agents, threads, runs, or tool calls.'

Replace generic verbs ('creating and managing') with sharper actions like 'create agents, manage threads and messages, execute and stream runs, and attach tools.'

Add common user phrasings or synonyms (e.g. 'Azure AI agent', 'persistent thread', 'agent run') to broaden natural trigger coverage.

Dimension	Reasoning	Score
Specificity	Names the domain and enumerates several concrete capabilities ('creating and managing AI agents with threads, messages, runs, and tools'), but the verbs 'creating and managing' remain slightly generic, leaving minor coverage gaps.	4 / 5
Completeness	Clearly states what the SDK does, but there is no 'Use when...' clause or equivalent explicit trigger guidance, so completeness is capped at 3 per the rubric.	3 / 5
Trigger Term Quality	Includes natural terms a user would say ('Azure AI Agents', '.NET', 'AI agents') with good coverage, but misses common synonyms or phrasings users might use when requesting agent work.	4 / 5
Distinctiveness Conflict Risk	The 'Azure AI Agents Persistent SDK for .NET' niche is clearly distinct, with only minor overlap risk against the related high-level Azure.AI.Projects SDK.	4 / 5
	Total	15 / 20 Passed

Validation

93%

Warnings & errors only

Checks the skill against the spec for correct structure and formatting. All validation checks must pass before discovery and implementation can be scored.

Validation — 15 / 16 Passed

Validation for skill structure

Criteria	Description	Result
frontmatter_unknown_keys	Unknown frontmatter key(s) found; consider removing or moving to metadata	Warning

	Total	15 / 16 Passed

Repository: administrakt0r/AI-Agents-Safe-Coding-Skills
Path: plugins/AI-Agents-Safe-Coding-Skills/skills/azure-ai-agents-persistent-dotnet/SKILL.md
Commit: debb2ec

Reviewed: 1 day ago

Table of Contents

Discovery Implementation Validation

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.