azure-ai-translation-text-py

Azure AI Text Translation SDK for real-time text translation, transliteration, language detection, and dictionary lookup. Use for translating text content in applications.

2.00x

Quality

72%

Does it follow best practices?

Impact

96%

2.00x

Average score across 3 eval scenarios

Securityby

Low

Low-risk findings worth noting

Fix and improve this skill with Tessl

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

Quality

Content

77%Scale 1-3

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 excellent executable code examples covering all major Azure Text Translation operations. Its main weaknesses are moderate verbosity (could trim some sections or split into overview + reference) and a meaningless 'When to Use' section. The logical progression from setup through basic to advanced features is well done.

Suggestions

Remove the 'When to Use' section — it's a tautology that adds no value.

Consider splitting advanced features (dictionary lookup/examples, transliteration, translation options) into a separate REFERENCE.md to keep SKILL.md focused on quick-start essentials.

Remove inline comments that restate the obvious (e.g., '# Spanish' after 'es', '# From Latin script' after 'Latn') to improve conciseness.

Dimension	Reasoning	Score
Conciseness	The content is mostly efficient with good code examples, but includes some unnecessary elements like the 'When to Use' section (which is a meaningless tautology), minor redundant comments in code, and the brief descriptions before some sections that Claude wouldn't need. The best practices section is useful but could be tighter.	2 / 3
Actionability	Excellent actionability — every section provides fully executable, copy-paste ready Python code with correct imports, proper environment variable usage, and clear parameter names. The code covers all major SDK operations with concrete examples showing how to process results.	3 / 3
Workflow Clarity	This is primarily an API reference skill rather than a multi-step destructive workflow, so the single-task nature of each section is appropriate. The setup flow (install → env vars → auth → use) is logically sequenced, and the methods table provides a clear overview of available operations.	3 / 3
Progressive Disclosure	The content is well-structured with clear section headers progressing from setup to basic to advanced features, and the methods table serves as a good summary. However, at ~200 lines it's somewhat long for a SKILL.md and could benefit from splitting detailed examples (dictionary, transliteration, options) into a separate reference file.	2 / 3
	Total	10 / 12 Passed

Description

67%Scale 1-3

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 does a good job listing specific capabilities and anchoring itself to the Azure AI Text Translation SDK, which provides clear distinctiveness. However, the 'Use for' clause is too generic and doesn't include natural trigger terms users might say (e.g., 'translate this text', 'what language is this', 'Azure Translator'). The trigger guidance needs expansion to help Claude reliably select this skill.

Suggestions

Expand the 'Use for' clause with more explicit trigger scenarios, e.g., 'Use when the user asks to translate text between languages, detect what language text is in, transliterate scripts, or perform dictionary lookups using Azure.'

Add natural user-facing trigger terms like 'translate', 'what language is this', 'Azure Translator', 'convert to another language', 'multilingual', or specific language pairs.

Dimension	Reasoning	Score
Specificity	Lists multiple specific concrete actions: 'real-time text translation, transliteration, language detection, and dictionary lookup.' These are distinct, well-defined capabilities.	3 / 3
Completeness	The 'what' is well-covered with specific capabilities, and there is a 'Use for...' clause, but the 'when' trigger is vague ('translating text content in applications') and doesn't provide explicit trigger scenarios or user phrases that would help Claude distinguish when to select this skill.	2 / 3
Trigger Term Quality	Includes some relevant keywords like 'translation', 'transliteration', 'language detection', 'dictionary lookup', and 'Azure AI', but misses common user variations like 'translate', 'convert language', 'detect language', specific language names, or 'localization'.	2 / 3
Distinctiveness Conflict Risk	The mention of 'Azure AI Text Translation SDK' clearly scopes this to a specific platform and SDK, making it highly distinguishable from generic translation or language skills. The specific capabilities like transliteration and dictionary lookup further narrow the niche.	3 / 3
	Total	10 / 12 Passed

Validation

90%

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 — 10 / 11 Passed

Validation for skill structure

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

	Total	10 / 11 Passed

Repository: administrakt0r/AI-Agents-Safe-Coding-Skills
Path: skills/azure-ai-translation-text-py/SKILL.md
Commit: fbdfd63

Reviewed: 3 days 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.