CtrlK
BlogDocsLog inGet started
Tessl Logo

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.

62

Quality

73%

Does it follow best practices?

Run evals on this skill

Adds up to 20 points to the overall score

View guide

SecuritybySnyk

Passed

No findings from the security scan

Fix and improve this skill with Tessl

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

Quality

Content

72%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 body is a strong, highly actionable SDK reference: complete executable examples for every client method, ordered sensibly from setup to advanced options. Its weaknesses are structural rather than instructional — no error-handling/validation guidance for batch API calls (capping workflow clarity) and a single monolithic file where a split reference would improve progressive disclosure.

Suggestions

Add an error-handling section showing try/except around client calls (e.g., catching HttpResponseError and inspecting error.code) so batch translation workflows include a validate/retry checkpoint, and note verifying per-item results for large batches.

Split advanced material (Translation Options, Dictionary Lookup/Examples, the full get_supported_languages walkthrough) into a references/ file linked one level deep from SKILL.md, keeping the main file as a lean quick-start overview.

Delete the boilerplate 'When to Use' sentence and tighten the Limitations section to skill-specific caveats (e.g., rate limits, the 100-text batch cap, region requirement) to remove filler tokens.

DimensionReasoningScore

Conciseness

The bulk of the body is dense, executable code with almost no explanation of concepts Claude already knows, and section headers do real navigational work. Minor trims are available — the overview line duplicates the description, the Language Detection section re-demonstrates detected_language already shown in Basic Translation, and the boilerplate "This skill is applicable to execute the workflow or actions described in the overview" When-to-Use line is pure filler — fitting anchor 4 rather than anchor 5's every-token-earns-its-place.

4 / 5

Actionability

Nearly every section is copy-paste-ready Python: installation command, env-var setup, three complete authentication variants, and runnable examples for translate, transliterate, dictionary lookup/examples, supported languages, break sentence, options, and async usage. Coverage spans the common cases exactly as anchor 5 requires; the only nit (the async snippet reuses `key`/`region` from earlier sections) is too minor to drop it to anchor 4.

5 / 5

Workflow Clarity

Sections follow a coherent install → env vars → authenticate → call order, but the skill involves batch operations ("Send multiple texts in one request (up to 100)") and shows no error handling, result verification, or retry guidance — no try/except, no API error examples. Per the rubric, missing validation/feedback loops for batch operations caps workflow clarity at 3 even though the sequence itself is orderly.

3 / 5

Progressive Disclosure

No bundle files exist (references/, scripts/, assets/ are all absent), so ~275 lines of API reference live entirely inline in SKILL.md. Sections are well organized with clear headers, but content that would fit a separate reference file (Translation Options, Dictionary Examples, the full language-listing walkthrough) is inlined with no one-level-deep references — matching anchor 3 ('content that should be separate is inline') rather than anchor 4's mostly-split structure; the under-50-lines exception for a single file does not apply at this length.

3 / 5

Total

15

/

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, appropriately concise description: it names the SDK and four concrete capabilities and includes an explicit 'Use for' trigger clause, all in third person. It stops short of top marks because the 'when' clause is generic, a few capabilities documented in the body are unmentioned, and natural synonyms (localization, i18n) are absent.

DimensionReasoningScore

Specificity

The description lists four concrete actions — "real-time text translation, transliteration, language detection, and dictionary lookup" — but omits operations the skill itself documents (break-sentence boundaries, supported-language listing), leaving minor coverage gaps. This matches anchor 4 ('several specific actions; minor gaps') rather than anchor 5's comprehensive coverage, and is well above anchor 3's '1-2 concrete actions'.

4 / 5

Completeness

The 'what' is concrete and specific (four named capabilities) and a trigger clause is present ("Use for translating text content in applications"), so both parts exist. The 'when' is generic — no concrete trigger scenarios or phrasings a user would actually say — matching anchor 4 ('when could be more explicit or specific') rather than anchor 5's explicit trigger phrases.

4 / 5

Trigger Term Quality

Natural phrases users would say are present — "translating text content", "text translation", "language detection" — giving good keyword coverage anchored by the Azure/SDK domain terms. It falls short of anchor 5 because common synonyms like "localization", "i18n", or "convert text to another language" are missing, but exceeds anchor 3 since the core natural terms are covered.

4 / 5

Distinctiveness Conflict Risk

"Azure AI Text Translation SDK" carves out a clear niche with low conflict risk against unrelated skills. Minor overlap remains with closely related Azure offerings (document translation, speech translation) since the trigger clause doesn't scope to text-only translation, fitting anchor 4 rather than anchor 5's minimal-conflict framing.

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
sickn33/agentic-awesome-skills
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.