CtrlK
BlogDocsLog inGet started
Tessl Logo
SkillPublic

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.

83

2.00x
Quality

80%

Does it follow best practices?

Impact

96%

2.00x

Average score across 3 eval scenarios

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-translation-text-py/SKILL.md

The canonical home for this skill is azure-ai-translation-text-py in sickn33/agentic-awesome-skills

SKILL.md
Quality
Evals
Security

Quality

Content

78%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 strong, code-first reference: nearly every section is executable and covers the SDK's real operations, with a logical setup-to-advanced progression. Weaknesses are the absence of any progressive disclosure (all reference material is inlined with no external files), the lack of error-handling/verification guidance, and a small amount of filler (duplicate intro, circular 'When to Use' section).

Suggestions

Split bulk reference material into one-level-deep bundle files, e.g. references/methods.md for the full method/options catalog and references/dictionary.md for dictionary lookup/examples, leaving SKILL.md as a quick-start overview with clearly signaled links.

Remove the circular 'When to Use' section ("This skill is applicable to execute the workflow or actions described in the overview.") and the duplicated intro sentence, which restate the description without adding information.

Add a brief error-handling note (e.g., catching azure.core.exceptions.ClientAuthenticationError for bad keys/regions and checking response.status_code) so failures during setup and batch translation have a recovery path.

DimensionReasoningScore

Conciseness

The body is dominated by tight, executable code blocks with almost no explanation of concepts Claude already knows, and short one-line section intros. It isn't a 5 because of small trims available: the intro line duplicates the description, comments like "# e.g., eastus, westus2" and "Convert text from one script to another:" add little, and the closing "When to Use" section ("This skill is applicable to execute the workflow or actions described in the overview.") is circular filler that earns no tokens.

4 / 5

Actionability

Fully executable, copy-paste-ready guidance covering the common cases: pip install, three complete authentication patterns, translate to one/multiple languages, source-language specification, detection, transliteration, dictionary lookup and examples, supported-languages listing, break-sentence, options flags, and the async client. Every snippet is real code with concrete parameter values, matching the 5 anchor.

5 / 5

Workflow Clarity

The sequence (Installation → Environment Variables → Authentication → basic → advanced usage → method table → best practices) is clear and logically ordered, and each operation is self-contained and unambiguous. It is not a 5 because there are no checkpoints or error-handling guidance (e.g., what to do on a 401/403 or quota error), and no guidance on verifying setup before running — though as non-destructive read-style API calls, hard validation steps are less critical than for destructive workflows.

4 / 5

Progressive Disclosure

There are no bundle files at all — no references/, scripts/, or assets/ — and ~270 lines of full API reference are inlined in SKILL.md. Section headers keep it navigable (better than the unstructured 2 anchor), but content that clearly belongs in separate files (e.g., the full client-method reference, options catalog, dictionary examples) is all inline with no one-level-deep references, matching the 3 anchor.

3 / 5

Total

16

/

20

Passed

Description

75%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.

A solid description: it names the domain and four concrete capabilities and includes an explicit 'Use for...' clause. Its main weakness is that the trigger clause is somewhat circular and misses natural synonyms and trigger variations users would actually say.

Suggestions

Broaden trigger terms with natural user phrasings, e.g. 'Use when the user asks to translate, localize, or transliterate text, detect the language of a string, or look up word translations (e.g., translate to Spanish).'

Make the 'when' clause add conditions beyond restating the 'what' — mention scenarios such as multilingual apps, batch text translation, or language detection rather than only 'translating text content in applications'.

Consider mentioning environment hints (Azure subscription / Translator resource) so users with Azure credentials recognize this as the right skill.

DimensionReasoningScore

Specificity

The description lists several concrete actions — "real-time text translation, transliteration, language detection, and dictionary lookup" — against a named domain (Azure AI Text Translation SDK). It falls short of the 5 anchor because secondary capabilities (break-sentence detection, dictionary examples) are absent, leaving minor gaps in coverage.

4 / 5

Completeness

The 'what' is clear (SDK for translation, transliteration, detection, dictionary lookup) and an explicit 'when' clause exists: "Use for translating text content in applications." However, the 'when' largely restates the 'what' rather than giving concrete trigger phrases (e.g., 'when the user asks to translate or localize text'), matching the 4 anchor rather than the explicit 5 anchor.

4 / 5

Trigger Term Quality

Natural phrases like "text translation", "transliteration", "language detection", and "dictionary lookup" cover what users would say, and "translating text content" is a natural trigger phrasing. It misses common variations users might say such as "localize", "i18n", "convert text to another language", or "Azure Translator", so it fits the 'good keyword coverage; a few natural terms missing' anchor rather than the comprehensive 5.

4 / 5

Distinctiveness Conflict Risk

"Azure AI Text Translation SDK" carves out a clear niche, and the enumerated operations are distinctive. There is minor overlap risk with closely related skills (other translation providers, general localization skills), so it fits 'mostly distinct; minor overlap risk' rather than the minimal-conflict 5.

4 / 5

Total

16

/

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-translation-text-py/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.