azure-ai-translation-document-py

Azure AI Document Translation SDK for batch translation of documents with format preservation. Use for translating Word, PDF, Excel, PowerPoint, and other document formats at scale.

Quality

70%

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

Quality

Content

57%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 highly actionable with comprehensive executable examples, but it suffers from a duplicated formats section, generic closing boilerplate, a missing retry/validation feedback loop for a batch operation, and no progressive disclosure into separate files. Tightening these would materially raise the score.

Suggestions

Remove the generic 'When to Use' and 'Limitations' boilerplate or replace it with skill-specific guidance (e.g., concrete retry steps for failed documents).

Add an explicit validation/feedback loop to the basic workflow: after polling, if documents_failed_count > 0, iterate list_document_statuses, inspect errors, and retry or report the failed documents.

Deduplicate the two 'Supported Formats' sections into one, and consider moving the rarer recipes (glossary, async, single-document) into a separate reference file linked from the overview.

Dimension	Reasoning	Score
Conciseness	Code examples are lean, but the body duplicates a 'Supported Formats' section (API call plus table) and ends with generic boilerplate in 'When to Use' and 'Limitations' ('applicable to execute the workflow...', 'Do not treat the output as a substitute...') that adds tokens without skill-specific value.	3 / 5
Actionability	Provides concrete, mostly copy-paste-ready code for auth, batch and single translation, status checks, glossaries, formats/languages, and async; minor gaps include undefined variables (target_url_es/fr/de) and an 'inputs=[...]' placeholder in the async example.	4 / 5
Workflow Clarity	The basic flow shows submit -> wait -> print succeeded/failed counts and separate sections cover status/error inspection, but there is no explicit validate-checkpoint or fix-retry feedback loop, and the batch-operation cap limits this to 3.	3 / 5
Progressive Disclosure	Sections are well-organized, but ~250 lines of API-recipe content are inlined entirely in SKILL.md with no external references; the over-50-lines simple-skill exception does not apply, so content that could be split into reference files keeps it at anchor 3.	3 / 5
	Total	13 / 20 Passed

Description

82%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 strong: it explicitly answers both what the skill does and when to use it, with concrete format-based triggers and a clear niche. The only weakness is that the action list is narrow (batch translation + format preservation) rather than enumerating several distinct capabilities.

Dimension	Reasoning	Score
Specificity	Names the domain plus 'batch translation of documents with format preservation' as 1-2 concrete actions; the Word/PDF/Excel/PowerPoint list names inputs rather than distinct capabilities, so it does not reach the 'several specific actions' of anchor 4.	3 / 5
Completeness	Clearly states what ('batch translation of documents with format preservation') and gives an explicit 'Use for translating ...' trigger with concrete phrases, matching the anchor-5 pattern.	5 / 5
Trigger Term Quality	'translating Word, PDF, Excel, PowerPoint, and other document formats at scale' gives good natural keyword coverage users would actually say, but lacks file extensions and synonyms that anchor 5 requires.	4 / 5
Distinctiveness Conflict Risk	Targets a specific niche (Azure AI Document Translation SDK, batch, format-preserving) with distinct format-based triggers, giving minimal overlap risk with other skills.	5 / 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-document-py/SKILL.md
Commit: 1f67c44

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