CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

azure-ai-projects-ts

High-level SDK for Azure AI Foundry projects with agents, connections, deployments, and evaluations.

Quality

69%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide
SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./plugins/AI-Agents-Safe-Coding-Skills-claude/skills/azure-ai-projects-ts/SKILL.md

The canonical home for this skill is azure-ai-projects-ts in sickn33/agentic-awesome-skills

SKILL.md
Quality
Evals
Security

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.

A well-structured, highly actionable API cookbook: nearly all content is executable TypeScript organized under clear section headers. The main weaknesses are the absence of any validation/verification steps around destructive operations, minor gaps in the code examples (undefined identifiers, unused env var, two operation groups with no examples), and a monolithic single-file layout with no progressive disclosure for what is a large API surface.

Suggestions

Add validation checkpoints around destructive and batch operations, e.g. verify a deployment exists before running an agent, or confirm a dataset version before deleting it.

Split per-operation-group detail (datasets, indexes, tools reference) into a references/ file and keep SKILL.md as an overview with clearly signaled one-level-deep links.

Fix example gaps: define or annotate placeholder variables (vectorStoreId, connectionId), use MODEL_DEPLOYMENT_NAME consistently instead of hardcoding 'gpt-4o', and remove the duplicated getOpenAIClient flow and the filler 'When to Use' sentence.

DimensionReasoningScore

Conciseness

The body is lean and code-forward with essentially no explanation of concepts Claude already knows, but the getOpenAIClient/conversation flow is duplicated across 'Getting OpenAI Client' and 'Run Agent', and the closing 'When to Use' line ('This skill is applicable to execute the workflow or actions described in the overview') is pure filler. These are minor trimmable instances (anchor 4) rather than the every-token-earns-its-place quality of anchor 5.

4 / 5

Actionability

Concrete, largely copy-paste-ready TypeScript covers installation, auth, and every major operation group. Minor gaps keep it below anchor 5: 'vectorStoreId' and 'connectionId' are used but never defined, MODEL_DEPLOYMENT_NAME is declared as an environment variable but every example hardcodes 'gpt-4o' instead, and 'evaluators'/'memoryStores' appear in the operation table with no usage example.

4 / 5

Workflow Clarity

The 'Run Agent' section does give a clear sequence (create conversation, generate response, cleanup), but there are no validation or verification checkpoints anywhere, and destructive operations (agents.deleteVersion, conversations.delete, datasets.delete) are invoked without any check. The judging guideline capping workflow clarity at 3 for destructive/batch operations without validation applies.

3 / 5

Progressive Disclosure

There are no bundle files at all (no references/, scripts/, or assets/ directories exist), so ~285 lines of SDK API reference live entirely inline in SKILL.md. Section headers and the operation-group table provide real structure — better than anchor 2's header-less wall — but a reference this size would benefit from splitting into reference files, and no external references exist to signal, fitting anchor 3.

3 / 5

Total

14

/

20

Passed

Description

61%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 clearly identifies its domain (Azure AI Foundry SDK) and lists its capability areas, but is noun-heavy with no action verbs and completely lacks a 'Use when...' trigger clause. Adding explicit trigger guidance and the TypeScript/JavaScript language marker would address the main gaps.

Suggestions

Add a 'Use when...' clause with concrete triggers, e.g. 'Use when building TypeScript/JavaScript apps against Azure AI Foundry, creating AI agents, or running evaluations.'

Include the language discriminator ('TypeScript'/'JavaScript') so the skill is distinguishable from Python-variant Azure AI Foundry skills.

Convert the capability nouns into concrete actions (e.g. 'Create and run AI agents, manage connections and deployments, evaluate model outputs').

DimensionReasoningScore

Specificity

The description names the domain ('Azure AI Foundry projects') and four concrete capability areas ('agents, connections, deployments, and evaluations'), but contains no action verbs whatsoever — it describes what the SDK covers, not what it does. This matches anchor 3 (domain plus concrete items, not comprehensive) better than anchor 2, since listing four specific areas is more informative than a single generic action like 'Processes PDF files', but it falls short of anchor 4, which requires specific actions to be stated.

3 / 5

Completeness

The 'what' is clearly stated ('High-level SDK for Azure AI Foundry projects with agents, connections, deployments, and evaluations') but there is no 'Use when...' clause or any equivalent explicit trigger guidance, which the judging guidelines state caps completeness at 3.

3 / 5

Trigger Term Quality

Good natural keyword coverage including 'Azure AI Foundry', 'agents', 'deployments', and 'evaluations' that users would plausibly say. Not anchor 5 because it is missing key synonyms and discriminator terms — most notably 'TypeScript'/'JavaScript'/'npm', which is the primary way a user would distinguish this skill from the Python variant of the same SDK.

4 / 5

Distinctiveness Conflict Risk

'Azure AI Foundry' is a clear, distinctive niche that most skills would not conflict with. Not anchor 5 because without 'TypeScript' in the description, this skill would collide with a Python-variant Azure AI Foundry skill and overlaps somewhat with Azure OpenAI SDK skills.

4 / 5

Total

14

/

20

Passed

Validation

93%

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

CriteriaDescriptionResult

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-claude/skills/azure-ai-projects-ts/SKILL.md

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.