azure-ai-translation-text-py

Azure AI Text Translation SDK for real-time text translation, transliteration, . Use for translating text content in applications.

Quality

68%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

Securityby

Passed

No findings from the security scan

Fix and improve this skill with Tessl

tessl review fix ./skills/azure-ai-translation-text-py/SKILL.md

Quality

Content

82%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 body is a lean, highly actionable SDK usage guide with executable examples across the main translation and transliteration operations and a logical progression from installation through advanced options. Its main weaknesses are minor filler and the absence of any progressive-disclosure split for a document slightly longer than ideal.

Dimension	Reasoning	Score
Conciseness	The body is code-forward with minimal prose and assumes Python competence, but minor filler remains (the generic 'When to Use' line and a trailing blank code fence), fitting 'efficient; minor instances that could be trimmed' rather than the fully lean 5.	4 / 5
Actionability	It provides fully executable, copy-paste-ready code for installation, authentication, translation, transliteration, language listing, options, and async usage, covering the common cases as the anchor for 5 requires.	5 / 5
Workflow Clarity	The single-purpose stateless API skill is organized into a clear install -> configure -> use sequence; no validation checkpoints are needed because translation is non-destructive, so it sits at 'clear sequence with minor gaps' rather than the checkpoint-driven 5.	4 / 5
Progressive Disclosure	With no bundle files present, the single SKILL.md is well-structured via clear section headers and a methods table, but at ~188 lines with no reference split it matches 'good structure; minor organization gaps' rather than the one-level-deep reference pattern of a 5.	4 / 5
	Total	17 / 20 Passed

Description

53%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 identifies a specific Azure SDK and two concrete capabilities but suffers from a grammatical break and a weak, generic 'Use for' trigger that restates the 'what' rather than adding a distinct activation context. It is moderately specific and distinctive yet incomplete in its trigger guidance.

Suggestions

Fix the broken 'transliteration, .' fragment and rewrite as a clean clause, e.g. 'Azure AI Text Translation SDK for real-time text translation and transliteration.'

Replace the generic 'Use for translating text content in applications' with concrete triggers, e.g. 'Use when translating or transliterating text with Azure Translator, converting scripts, or working with the azure-ai-translation-text SDK.'

Add a missing capability (language operations / get_supported_languages) to raise specificity toward comprehensive coverage.

Dimension	Reasoning	Score
Specificity	Phrases 'real-time text translation, transliteration' name the domain and two concrete actions, matching the anchor for 1-2 concrete actions without comprehensive coverage; it is not a 4 because only two actions are listed and the sentence is marred by a broken ', .' clause.	3 / 5
Completeness	It states a clear 'what' and includes a 'Use for' clause, but the 'when' merely restates the what plus filler ('in applications') with no distinct trigger context, and a grammatical break muddies the statement, placing it closer to 'what clear, when weakly implied' than to a 4.	3 / 5
Trigger Term Quality	Natural terms like 'text translation', 'transliteration', and 'translating text content' appear, but common synonyms and product-specific phrasing ('Azure Translator') are missing and the 'Use for ... in applications' trigger is generic, fitting the 'some relevant keywords but missing variations' anchor.	3 / 5
Distinctiveness Conflict Risk	Naming the specific 'Azure AI Text Translation SDK' gives a clear niche with minimal conflict risk; it is not a 5 because the trigger 'translating text content' is generic enough to overlap with other translation skills.	4 / 5
	Total	13 / 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: skills/azure-ai-translation-text-py/SKILL.md
Commit: debb2ec

Reviewed: 17 hours 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.