Agent skill

Translation

by seb1n in seb1n/awesome-ai-agent-skills

Translate text between languages with cultural adaptation, terminology consistency, and support for multiple document types including technical docs, marketing copy, and UI strings.

MITAuto-check passedWriting & Content

Install Translation

skills CLI
$ npx skills add seb1n/awesome-ai-agent-skills --skill translation -a claude-code

Project install by default; add -g for ~/.claude/skills/.

GitHub CLI
$ gh skill install seb1n/awesome-ai-agent-skills translation --agent claude-code

Project scope by default; add --scope user for a personal install. Needs GitHub CLI 2.90.0 or later (public preview).

Manual copy
$ git clone --depth 1 https://github.com/seb1n/awesome-ai-agent-skills.git skills-src && mkdir -p .claude/skills && cp -r skills-src/writing-and-content/translation .claude/skills/translation && rm -rf skills-src

Use ~/.claude/skills/ instead of .claude/skills for a personal install. The folder must contain SKILL.md.

Claude Code skills documentation · loads skills from .claude/skills/

Facts

Skill name
translation
GitHub stars
206
Token cost
~1.9k tokens
SKILL.md length
900 words
Files
1
Skills in repo
101
Repo updated
First seen
Licence
MIT

At a glance

Translate text between languages with cultural adaptation, terminology consistency, and support for multiple document types including technical docs, marketing copy, and UI strings.

  • Works in 6 steps: Analyze Source Context → Research Terminology → Translate the Content → …
  • The user requests translation
  • SKILL.md covers Workflow, Usage, Examples and Best Practices, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Translation is an agent skill from seb1n/awesome-ai-agent-skills. Translate text between languages with cultural adaptation, terminology consistency, and support for multiple document types including technical docs, marketing copy, and UI strings. Use when the user requests translation or provides relevant inputs for this workflow.

Its SKILL.md is about 1.9k tokens, which your agent loads only when the skill is triggered. It is a single SKILL.md file with no bundled scripts.

It sits in Writing & Content, covering Translation and Copywriting. The repository describes itself as: 103 ready-to-use AI agent skills for Claude Code, OpenAI Codex, Gemini CLI, Cursor, GitHub Copilot, Windsurf, and other Agent Skills-compatible tools. Complete SKILL.md… The licence is MIT.

When your agent uses it

  • The user requests translation
  • Provides relevant inputs for this workflow

Example prompts

  • “/translation”

Workflow steps

6 steps, taken from the first numbered list in SKILL.md.

  1. Analyze Source Context
  2. Research Terminology
  3. Translate the Content
  4. Localize Cultural References
  5. Review for Accuracy and Fluency
  6. Deliver with Annotations

What it can do on your machine

Read from SKILL.md and the folder at commit 75865a5. It shows what the files ask for, not the result of running them.

  • Tool permissions

    Pre-approves nothing: there is no allowed-tools line, so your agent's usual permission prompts apply.

    From allowed-tools in the SKILL.md frontmatter.

  • Runs code

    No scripts in the folder and no shell commands in SKILL.md (its code samples are json).

    From the folder's file list and the shell code blocks in SKILL.md.

  • Network

    No URLs in SKILL.md.

    From URLs in SKILL.md, links to its own repository left out.

  • Credentials

    Names no API keys, tokens, secrets or passwords.

    From names ending in _API_KEY, _TOKEN, _SECRET, _KEY or _PASSWORD in SKILL.md.

Context cost

Translation loads about 1.9k tokens when it runs. Until then it costs about 70 tokens; SKILL.md has 900 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~70
When it runs · the whole SKILL.md, loaded when a task matches
~1.9k

Estimates: characters ÷ 4, the usual rule of thumb; real counts depend on the model's tokenizer. Scripts and assets cost tokens only if the agent reads them.

Safety

Auto-check passed

The automated check found no risky patterns in SKILL.md.

Automated static check — not a guarantee. Review scripts before installing. It scans the text of SKILL.md for risky patterns (piping downloads into a shell, reading credential files, hidden Unicode, destructive commands); files beside SKILL.md are not scanned.

SKILL.md

The full file from seb1n/awesome-ai-agent-skills at commit 75865a5, republished under its MIT licence (© seb1n). 900 words, ~1,933 tokens.

Download SKILL.mdSave it as .claude/skills/translation/SKILL.md (or your agent's skills folder).
name
translation
description
Translate text between languages with cultural adaptation, terminology consistency, and support for multiple document types including technical docs, marketing copy, and UI strings. Use when the user requests translation or provides relevant inputs for this workflow.
license
MIT
metadata.author
awesome-ai-agent-skills
metadata.version
1.0.0

Translation

This skill enables an AI agent to translate text between languages while preserving meaning, tone, and context. It goes beyond word-for-word substitution by handling idiomatic expressions, cultural nuance, domain-specific terminology, and formality registers. The agent can translate technical documentation, marketing copy, UI strings, legal text, and general prose, adapting output to the conventions of the target locale.

Workflow

  1. Analyze Source Context Examine the source text to determine its domain (technical, marketing, legal, casual), register (formal, informal, neutral), and intended audience. Identify any idiomatic expressions, culturally specific references, or humor that will require adaptation rather than literal translation. Note the document format (plain text, Markdown, JSON, HTML) so structure is preserved in the output.

  2. Research Terminology For specialized content, build or consult a terminology glossary to ensure consistency. Technical documents require exact translations of domain terms (e.g., "endpoint" stays "endpoint" in many languages or maps to an accepted equivalent). Marketing copy may need creative transcreation rather than direct translation. If the user provides a glossary or translation memory, integrate it before proceeding.

  3. Translate the Content Produce the translation following the determined tone, formality level, and terminology. Preserve all formatting markers such as Markdown headings, code blocks, HTML tags, and JSON keys. For UI strings, keep placeholder tokens (e.g., {username}, %d) intact and in the correct grammatical position for the target language. Handle pluralization rules specific to the target language.

  4. Localize Cultural References Adapt units of measurement, date formats, currency symbols, and culturally bound metaphors to the target locale. For example, convert miles to kilometers when translating for a European audience, or replace an American sports analogy with one that resonates in the target culture. For marketing content, ensure slogans and calls-to-action carry the same persuasive impact in the target language.

  5. Review for Accuracy and Fluency Re-read the translated text to verify grammatical correctness, natural phrasing, and faithful representation of the source meaning. Check that no sentences were accidentally omitted or duplicated. Confirm terminology consistency across the entire document by cross-referencing the glossary established in step 2.

  6. Deliver with Annotations Return the translated text in the same format as the source. Where translation choices were ambiguous, include brief translator notes explaining the reasoning. If the user requested multiple formality levels or regional variants, provide each variant clearly labeled.

Usage

Provide the text to translate along with the target language. Optionally specify:

  • Source language (if not auto-detectable)
  • Formality level — formal, informal, or neutral
  • Domain — technical, marketing, legal, medical, general
  • Glossary — key terms and their required translations
  • Output format — plain text, Markdown, JSON locale file, etc.

Example prompt: "Translate the following API error messages to Japanese (formal). Keep the JSON structure and all placeholder tokens intact."

Examples

Example 1: Translating a Technical Paragraph (English to German, Formal)

Input:

The authentication module uses OAuth 2.0 with PKCE to secure API requests. When a user initiates a login, the client generates a code verifier and code challenge. The authorization server validates the challenge before issuing an access token. Tokens expire after 3600 seconds and must be refreshed using the refresh token endpoint.

Output:

Das Authentifizierungsmodul verwendet OAuth 2.0 mit PKCE, um API-Anfragen abzusichern. Wenn ein Benutzer eine Anmeldung einleitet, erzeugt der Client einen Code-Verifier und eine Code-Challenge. Der Autorisierungsserver validiert die Challenge, bevor er ein Zugriffstoken ausstellt. Token laufen nach 3600 Sekunden ab und müssen über den Refresh-Token-Endpunkt erneuert werden.

Translator note: "Code Verifier," "Code Challenge," and "Refresh-Token-Endpunkt" are kept close to the English originals because these are established terms in the German-speaking developer community.

Show full SKILL.md (314 more words)Show less
Example 2: Localizing UI Strings (English to Spanish, JSON Locale File)

Input:

json
{
  "greeting": "Hello, {username}!",
  "items_in_cart": "You have {count} item(s) in your cart.",
  "checkout_button": "Proceed to Checkout",
  "empty_cart": "Your cart is empty. Start shopping!",
  "order_confirmation": "Your order #{orderId} has been placed on {date}."
}

Output:

json
{
  "greeting": "Hola, {username}!",
  "items_in_cart": "Tienes {count} artículo(s) en tu carrito.",
  "checkout_button": "Proceder al pago",
  "empty_cart": "Tu carrito está vacío. ¡Empieza a comprar!",
  "order_confirmation": "Tu pedido n.º {orderId} se ha realizado el {date}."
}

Translator note: Placeholder tokens {username}, {count}, {orderId}, and {date} are preserved exactly. The informal "tú" form is used; switch to "usted" for formal contexts.

Best Practices

  • Preserve formatting and structure. Never strip Markdown, HTML tags, or JSON keys during translation. The translated output must be drop-in compatible with the source format.
  • Maintain terminology consistency. Use the same translated term for a given source term throughout the entire document. Build a glossary at the start and reference it continuously.
  • Respect formality registers. Languages like Japanese, Korean, German, and Spanish have distinct formal and informal modes. Always confirm the desired register before translating.
  • Handle pluralization rules. Many languages have complex plural forms (e.g., Arabic has six). When translating UI strings with count-dependent text, account for the target language's pluralization system.
  • Avoid literal translation of idioms. Phrases like "hit the ground running" or "low-hanging fruit" should be replaced with equivalent expressions in the target language, not translated word-for-word.
  • Annotate ambiguous choices. When a source term has multiple valid translations, include a brief note explaining the chosen translation and alternatives.

Edge Cases

  • Untranslatable terms: Some technical terms (e.g., "API," "OAuth," "webhook") have no standard translation in certain languages. Keep them in the original language and note this decision.
  • Right-to-left languages: When translating to Arabic, Hebrew, or Persian, ensure that mixed-direction text (e.g., English brand names within Arabic sentences) is handled with proper bidirectional markers.
  • Character encoding: CJK languages may cause string length issues in fixed-width UI fields. Flag any translations that significantly exceed the source string's character count.
  • Gender-neutral language: Some target languages require grammatical gender. When the source is gender-neutral, ask the user for guidance or provide both gendered variants.
  • Empty or placeholder source text: If the source contains only placeholders or empty strings, return them unchanged and note that no translation was needed.

© seb1n, MIT. Rendered from Markdown: HTML in the file is shown as text, images as links, and headings moved down two levels. Raw file

Files

Just SKILL.md in writing-and-content/translation of seb1n/awesome-ai-agent-skills.

Open the folder on GitHubat commit 75865a5

Compare with similar skills

Translation next to the 5 skills that share the most tags, products or categories with it. Stars are the repository's; “used in” counts other GitHub owners with a copy.

Translation compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Translation this skillseb1n/awesome-ai-agent-skills206—~1.9kAutomated safety check: PassMIT
Humanities Writing Companiontizzy916/humanities-writing-companion435—~3.4kAutomated safety check: PassCC-BY-NC-4.0
Natural Chinesegarden-cosmos/natural-chinese-protocol143—~1.4kAutomated safety check: PassMIT
Humanize Koreansangrokjung/claude-forge852—~1.3kAutomated safety check: PassMIT
Med Cultureasgard-ai-platform/skills242—~4.2kAutomated safety check: PassMIT
Persian Writingali2000hos/persian-writing362—~4.4kAutomated safety check: WarnMIT

Similar skills

  • Humanities Writing Companion

    tizzy916/humanities-writing-companion

    Help with humanities scholarly writing: sharpen research questions, map supplied readings, plan and draft arguments, review chapters, preserve authorial voice, and respond to reviewers.

    435 GitHub stars~3.4k tokensUpdated 17 days ago
    Writing & ContentAuto-check passed
  • Natural Chinese

    garden-cosmos/natural-chinese-protocol

    A skill your agent uses whenever generating or rewriting Chinese text that needs to sound natural and human-written.

    143 GitHub stars~1.4k tokensUpdated 3 mo ago
    Writing & ContentAuto-check passed
  • Humanize Korean

    sangrokjung/claude-forge

    Clean up translation-ese and AI-writing tics in Korean prose so it reads like a person wrote it — content (facts, numbers, proper nouns, quotes) stays 100% unchanged, only style and rhythm are…

    852 GitHub stars~1.3k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Med Culture

    asgard-ai-platform/skills

    A skill your agent uses when the user wants to write a culture-and-arts news piece — exhibition coverage, performance reviews, artist interviews, cultural policy analysis, art market reporting, or…

    242 GitHub stars~4.2k tokensUpdated 4 mo ago
    Writing & ContentAuto-check passed
  • Persian Writing

    ali2000hos/persian-writing

    Write natural, human-sounding Persian (Farsi) and build correct right-to-left Persian deliverables.

    362 GitHub stars~4.4k tokensUpdated 5 days ago
    Documents & OfficeAuto-check: warnings
  • Arabic Copy Localizer

    growthack88/growth-marketing-os

    Marketing copy localization skill that converts English marketing copy (ads, landing pages, emails, CTAs) into native Egyptian Arabic عامية — or GCC dialect on request — with natural English…

    116 GitHub stars~1k tokensUpdated 7 days ago
    Frontend & DesignAuto-check passed

More from seb1n/awesome-ai-agent-skills

All 101 skills in this repo
  • Agent Red Teaming

    seb1n/awesome-ai-agent-skills

    Plan, execute, document, and retest authorized security assessments of AI agents and multi-agent workflows using safe adversarial cases, synthetic identities, canaries, and evidence-based findings.

    206 GitHub stars~2.8k tokensUpdated 2 mo ago
    Auto-check passed
  • Eu AI Act Readiness

    seb1n/awesome-ai-agent-skills

    Build a preliminary, evidence-based EU AI Act readiness assessment across AI-system inventory, territorial scope, operator roles, prohibited-practice screening, risk classification, transparency…

    206 GitHub stars~3.3k tokensUpdated 2 mo ago
    Auto-check passed
  • Human In The Loop

    seb1n/awesome-ai-agent-skills

    Design and verify auditable human oversight, approval gates, escalation paths, and safe state transitions for AI agent workflows.

    206 GitHub stars~2.5k tokensUpdated 2 mo ago
    Auto-check passed
  • MCP Server Building

    seb1n/awesome-ai-agent-skills

    Design, implement, harden, and verify Model Context Protocol (MCP) servers with precise tool contracts, least-privilege authorization, safe transports, structured errors, and interoperability tests.

    206 GitHub stars~2.5k tokensUpdated 2 mo ago
    Auto-check passed
  • PDF Processing

    seb1n/awesome-ai-agent-skills

    Inspect, extract, OCR, create, merge, split, reorder, rotate, annotate, fill, redact, compress, secure, and verify PDF documents while preserving source files and visual fidelity.

    206 GitHub stars~2.5k tokensUpdated 2 mo ago
    Auto-check passed
  • Skill Supply Chain Audit

    seb1n/awesome-ai-agent-skills

    Audit agent skills, plugins, prompts, manifests, scripts, dependencies, and bundled assets for provenance, prompt-injection, permission, execution, exfiltration, persistence, and update risk.

    206 GitHub stars~2.4k tokensUpdated 2 mo ago
    Auto-check passed

Questions about Translation

What does Translation do?

Translate text between languages with cultural adaptation, terminology consistency, and support for multiple document types including technical docs, marketing copy, and UI strings. Translation is an agent skill from seb1n/awesome-ai-agent-skills. Translate text between languages with cultural adaptation, terminology consistency, and support for multiple document types including technical docs, marketing copy, and UI strings.

When should I use Translation?

Translation fits situations like: the user requests translation; provides relevant inputs for this workflow.

How do I install Translation in Claude Code?

Run `npx skills add seb1n/awesome-ai-agent-skills --skill translation -a claude-code`. Or copy the skill folder (writing-and-content/translation in seb1n/awesome-ai-agent-skills) into .claude/skills/translation in your project. Claude Code loads it when a task matches its description.

How do I install Translation in Codex?

Run `npx skills add seb1n/awesome-ai-agent-skills --skill translation -a codex`. Or copy the skill folder (writing-and-content/translation in seb1n/awesome-ai-agent-skills) into .agents/skills/translation in your project. Codex loads it when a task matches its description.

Can I use Translation in Cursor, Gemini CLI or GitHub Copilot?

Cursor, Gemini CLI, GitHub Copilot and OpenCode also load SKILL.md folders. With the skills CLI, run `npx skills add seb1n/awesome-ai-agent-skills --skill translation -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/translation, .gemini/skills/translation, .github/skills/translation and .opencode/skills/translation in your project.

What does Translation need to run?

SKILL.md names no scripts, command-line tools or credentials: Translation is instructions for the agent only.

Does Translation access the network?

SKILL.md contains no URLs. Any network use would come from the scripts or tools the agent runs. This is read from the text; nothing was executed.

Is Translation safe to install?

Our automated static check of SKILL.md found no risky patterns, such as piping downloads into a shell, reading credential files or hidden Unicode. It is not a guarantee. Review the folder before installing.

What licence does Translation use?

Translation is published under the MIT licence (declared in SKILL.md). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Translation use?

About 1.9k tokens (SKILL.md is roughly 7.7k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full.

What are the alternatives to Translation?

Skills that share tags, products or a category with Translation: Humanities Writing Companion (tizzy916/humanities-writing-companion, 435 stars), Natural Chinese (garden-cosmos/natural-chinese-protocol, 143 stars), Humanize Korean (sangrokjung/claude-forge, 852 stars) and Med Culture (asgard-ai-platform/skills, 242 stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Translation?

seb1n (a GitHub user) maintains it in seb1n/awesome-ai-agent-skills, which has 206 GitHub stars. The repository holds 101 skills in this directory. The repository was last updated on August 9, 2026.

Source: seb1n/awesome-ai-agent-skills on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.