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.
74
68%
Does it follow best practices?
Impact
Pending
No eval scenarios have been run
Passed
No known issues
Optimize this skill with Tessl
npx tessl skill review --optimize ./skills/azure-ai-translation-text-py/SKILL.mdQuality
Discovery
60%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 (translation, transliteration, language detection, dictionary lookup) and anchors itself to the Azure AI SDK. However, the 'Use for' clause is too generic and doesn't provide enough trigger detail to help Claude distinguish this from other translation skills. The trigger terms could be expanded with more natural user language variations.
Suggestions
Expand the 'Use for' clause with specific trigger scenarios, e.g., 'Use when the user needs to translate text between languages using Azure, detect what language text is written in, transliterate text to different scripts, or look up word translations and alternatives.'
Add natural trigger term variations users might say, such as 'translate', 'convert to English/Spanish/etc.', 'what language is this', 'Azure Translator', or 'multilingual'.
| 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. There is a 'Use for' clause but it's very generic ('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', and 'dictionary lookup', but misses common user variations like 'translate', 'convert language', 'detect language', 'Azure Translator', or specific file/content types users might mention. | 2 / 3 |
Distinctiveness Conflict Risk | Mentioning 'Azure AI Text Translation SDK' provides some distinctiveness, but 'translating text content in applications' is broad enough to overlap with other translation tools or general language processing skills. Could conflict with other translation-related skills. | 2 / 3 |
Total | 9 / 12 Passed |
Implementation
77%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 API reference skill with excellent actionability — every feature is demonstrated with complete, executable Python code. The main weaknesses are moderate verbosity (the document is long for a SKILL.md and includes some boilerplate sections) and the monolithic structure that could benefit from splitting detailed examples into a separate reference file. The generic 'When to Use' and 'Limitations' sections at the end add no meaningful value.
Suggestions
Remove the generic 'When to Use' and 'Limitations' boilerplate sections, which provide no SDK-specific guidance and waste tokens.
Consider moving detailed examples (dictionary lookup, dictionary examples, break sentence, translation options, async client) into a separate REFERENCE.md file, keeping SKILL.md as a concise overview with basic translation and authentication patterns.
| Dimension | Reasoning | Score |
|---|---|---|
Conciseness | The content is mostly efficient with good code examples, but includes some unnecessary sections like the generic 'When to Use' and 'Limitations' boilerplate that add no value. The best practices section is useful but some items are obvious. The one-line descriptions before code blocks (e.g., 'Convert text from one script to another') are borderline unnecessary for Claude. | 2 / 3 |
Actionability | All code examples are concrete, executable, and copy-paste ready. Authentication patterns, translation calls, transliteration, dictionary lookup, async usage, and various options are all demonstrated with complete, runnable Python code including proper imports and environment variable handling. | 3 / 3 |
Workflow Clarity | This is primarily an API reference skill rather than a multi-step destructive workflow, so the clear sequencing of setup (install → env vars → auth → usage) is appropriate. The methods table provides a clear overview of available operations. No destructive or batch operations requiring validation checkpoints are present. | 3 / 3 |
Progressive Disclosure | The content is well-structured with clear section headers progressing from setup to basic to advanced usage, but it's a fairly long monolithic document (~200 lines of content). The methods reference table, detailed examples for every method, and translation options could potentially be split into separate reference files for better token efficiency. | 2 / 3 |
Total | 10 / 12 Passed |
Validation
90%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
- sickn33/antigravity-awesome-skills
- Commit
76cbde3
- 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.