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.

Quality

81%

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

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 content is a well-organized, highly actionable SDK reference with executable examples for every common operation and minimal over-explanation. Its weakest aspect is the lack of progressive disclosure via separate reference files and some generic boilerplate sections.

Suggestions

Replace the generic "When to Use" line ("applicable to execute the workflow or actions described in the overview") with concrete guidance on when to reach for this skill over alternatives.

Move the fuller API surface (e.g., complete method reference, advanced translation options, async patterns) into a separate REFERENCE.md and link to it from SKILL.md to improve progressive disclosure.

Trim the boilerplate "Limitations" section to skill-specific constraints rather than generic guidance applicable to any skill.

Dimension	Reasoning	Score
Conciseness	The body is mostly lean executable code with brief section intros and avoids explaining concepts Claude already knows, though the generic "When to Use" and "Limitations" sections add minor boilerplate that could be trimmed.	4 / 5
Actionability	Provides fully executable, copy-paste-ready code covering the common cases — translate, transliterate, detect, dictionary lookup/examples, supported languages, break sentence, options, and async — matching the score-5 anchor.	5 / 5
Workflow Clarity	Organized in a logical install → authenticate → usage → reference → best practices progression with a methods table and best practices; no destructive or batch operation requires validation checkpoints, so the minor gaps do not cap the score.	4 / 5
Progressive Disclosure	Good structure with clear section headers organizing each capability, and inline usage examples are appropriate for an SDK overview; the gap is that no deeper reference files are provided for the fuller API surface.	4 / 5
	Total	17 / 20 Passed

Description

80%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 is specific and well-scoped to the Azure AI Text Translation SDK, listing four concrete capabilities with a present trigger clause. Its main weakness is the generic "in applications" trigger, which lacks concrete, natural trigger phrases.

Suggestions

Replace "Use for translating text content in applications" with concrete trigger phrasing such as "Use when translating text between languages, transliterating scripts, detecting languages, or looking up dictionary translations."

Add common synonyms users would naturally say (e.g., localize, multilingual, language pairs) to broaden trigger coverage.

Dimension	Reasoning	Score
Specificity	Lists multiple concrete actions — "real-time text translation, transliteration, language detection, and dictionary lookup" — giving comprehensive coverage of the SDK's capabilities, matching the score-5 anchor.	5 / 5
Completeness	Clearly states what the SDK does and includes an explicit "Use for translating text content in applications" trigger, satisfying both what and when, though the when could be more specific with concrete trigger phrases.	4 / 5
Trigger Term Quality	Includes natural terms users would say (translation, transliteration, language detection, dictionary lookup), but the trigger clause "Use for translating text content in applications" is somewhat generic and misses common phrasings like multilingual or localize.	4 / 5
Distinctiveness Conflict Risk	The Azure AI Text Translation SDK niche is distinct, but the broad trigger "translating text content in applications" carries minor overlap risk with other general translation skills.	4 / 5
	Total	17 / 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: sickn33/antigravity-awesome-skills
Path: skills/azure-ai-translation-text-py/SKILL.md
Commit: 1f67c44

Reviewed: about 15 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.