
translation
Translate, transcreate, review, or maintain multilingual product and marketing content, including source locking, glossary decisions, language style, machine-assisted workflows, legal-content safeguards, QA, and source-change synchronization. Use localization-strategy for market scope, locale architecture, rollout, and production release planning.
- Installs
- 2.3K
- Last 24h
- —
- Trending rank
- —
- Security
- Not audited
Install
Works with every agent the skills CLI supports.
npx skills add https://github.com/kostja94/marketing-skills --skill translation- 01
Install
Run the command in your project. The CLI asks which agents to install for.
- 02
Describe the task
Ask your agent for something this skill covers. It loads translation automatically when relevant.
- 03
Review the result
The agent follows the SKILL.md steps, scripts and references bundled with the skill.
SKILL.md
The instructions your agent reads when the skill is triggered.
Translation
Own the language-production lifecycle. Deliver natural, accurate target-language content without changing product facts, inventing market claims, or treating translated words as proof that a locale is ready to launch.
Boundaries
- This skill owns translation, transcreation, terminology, style, linguistic review, and keeping translations current.
- localization-strategy owns locale selection, page coverage, URL architecture, routing, rollout, and release verification.
- keyword-research owns target-market queries. Never translate a source keyword list and call it localized research.
- Project positioning, feature availability, legal facts, and approved terminology remain in their project SSOTs.
Prepare the Source
Read root contextus.md when present. Before translating, establish:
- source version and owner;
- content type and target locale or market;
- user task, audience, tone, and channel;
- product facts and claims that must remain unchanged;
- approved terminology, forbidden terms, and terms intentionally left untranslated;
- layout, UI, metadata, structured-data, or character constraints;
- review level required by business, legal, safety, or conversion risk.
If the source is unstable or contradictory, report the conflict before producing many dependent translations.
Choose the Right Treatment
| Treatment | Use when | Main risk |
|---|---|---|
| Direct translation | Meaning and context transfer cleanly | Literal but unnatural phrasing |
| Localization | Formats, examples, terminology, or market facts differ | Unverified adaptation |
| Transcreation | Taglines, campaigns, landing-page persuasion, or cultural framing must change | Drifting from the product promise |
| Machine-assisted translation with review | Volume is high and risk is controlled | Fluent factual or terminology errors |
| Specialist translation | Legal, regulated, safety-critical, or technically exact material | Liability from semantic change |
Machine translation is a production method, not an automatic quality verdict. Match review depth to risk and page importance. Do not publish raw machine output merely because it reads fluently.
Maintain Terminology
Use one project termbase or glossary rather than embedding competing lists in multiple plans. Useful fields include:
- source term and approved target term;
- definition or product context;
- allowed variants and forbidden translations;
- keep-untranslated decision;
- locale or market scope;
- owner and approval status.
Distinguish brand names, registered entities, product features, technical standards, generic category terms, UI labels, and search-language variants. A search phrase may differ from the UI term; document the role rather than forcing one string everywhere.
Translate by Content Type
Product UI
- preserve action, state, and error meaning;
- check interpolation variables, plurals, gender, truncation, line wrapping, and RTL behavior;
- review strings in screen context, not only in a spreadsheet;
- keep the same concept named consistently across navigation, onboarding, billing, and help.
Marketing and Landing Pages
- preserve the page's audience, product promise, evidence, and desired action;
- use natural target-market phrasing and approved query language without keyword stuffing;
- adapt examples, proof, CTA, and objection handling only when the market facts support the change;
- keep Title, H1, description, body, and social copy semantically aligned without requiring identical strings.
Articles and Documentation
- preserve technical meaning, examples, code, citations, and internal-link intent;
- localize headings and anchors only when the publishing system supports the resulting links;
- keep source and localized update states visible so stale versions can be found.
Legal and Regulated Content
- preserve section correspondence, parties, defined terms, numbers, dates, rights, obligations, prohibitions, governing law, and dispute terms;
- do not add a “source language prevails” clause or change legal effect without authorized legal direction;
- record unresolved ambiguity for counsel rather than silently choosing a convenient interpretation;
- require specialist review before release.
Production Workflow
- Lock the source version and collect context.
- Load the project glossary and style guidance.
- Produce a first pass using the selected treatment.
- Run terminology, factual, completeness, and formatting checks.
- Review in the rendered product or page context.
- Complete native or specialist review at the required risk level.
- Mark the content ready and record its source version.
- When the source changes, calculate affected strings or sections, move the translation to
outdated, and review only after understanding the semantic change.
Suggested lifecycle states are translation-draft, review, localized-ready, outdated, and not-applicable. Use the project's existing state model when one exists.
Quality Gates
Check what matters for the artifact:
- no missing or accidentally untranslated user-facing content;
- approved terms and intentional untranslated terms are respected;
- claims, numbers, links, entities, prices, and feature availability match verified facts;
- grammar, register, punctuation, dates, numbers, units, and address formats suit the locale;
- UI variables, markup, links, and code remain valid;
- metadata and headings match the localized page intent;
- the rendered page has no clipping, mixed-language fallback, broken RTL, or inaccessible controls;
- the source version and approval state are traceable.
For large inventories, test every template and risk tier plus representative pages; do not pretend a small sample proves every page correct.
Output
Return the requested translation or review result plus only the supporting artifacts needed, such as:
- translator brief;
- approved and unresolved terminology decisions;
- translated or transcreated copy;
- issues requiring product, legal, or market decisions;
- QA and rendered-context findings;
- source-version and update-status notes.
Do not create a new translation-plan document when an existing project context, glossary, CMS workflow, or Skill should be updated.
Related Skills
- localization-strategy: locale scope, architecture, migration, rollout, and production validation
- keyword-research: target-market queries and search intent
- page-metadata, title-tag, meta-description, heading-structure: localized search and page copy
- copywriting, content-optimization: source and target copy quality
FAQ
What does the translation skill do?
Translate, transcreate, review, or maintain multilingual product and marketing content, including source locking, glossary decisions, language style, machine-assisted workflows, legal-content safeguards, QA, and source-change synchronization. Use localization-strategy for market scope, locale architecture, rollout, and production release planning.
How do I install translation?
Run npx skills add https://github.com/kostja94/marketing-skills --skill translation in your project. The skills CLI detects the agents you use and copies the skill into the right folder. For Claude Code you can also place the skill folder at ~/.claude/skills/translation/ (personal) or .claude/skills/translation/ (project).
Which AI agents can use translation?
Any agent that supports the open Agent Skills format (a folder with a SKILL.md file), including Claude Code, Codex, Cursor, GitHub Copilot, Gemini CLI, Windsurf, Cline, OpenCode and more.
Is translation safe to install?
No partner security audit is available yet. Skills can run commands and scripts, so read the SKILL.md and any bundled files before installing.
Who maintains translation?
It is published by kostja94 in kostja94/marketing-skills. It has 2,320 recorded installs.
More from kostja94/marketing-skills
copywriting
kostja94/marketing-skills
When the user wants to write or optimize short-form marketing copy—headlines, CTAs, ad copy, landing page copy, email copy. Also use when the user mentions "copywriting," "headline," "CTA copy," "ad copy," "landing page copy," "sales copy," "conversion copy," "PAS," "AIDA," "BAB," "copy formula," or "differentiation." For long-form article bodies (blog posts, guides), use article-content.
linkedin-posts
kostja94/marketing-skills
When the user wants to create LinkedIn post copy or optimize for LinkedIn. Also use when the user mentions "LinkedIn post," "LinkedIn article," "professional post," "post to LinkedIn," "LinkedIn content," "LinkedIn copy," "B2B LinkedIn," "LinkedIn engagement," "LinkedIn feed," "share box," "document post," "poll," "Newsletter," "reshare," or "LinkedIn marketing." For LinkedIn ads, use linkedin-ads.
youtube-seo
kostja94/marketing-skills
When the user wants to optimize YouTube videos for search, create video descriptions, or improve channel visibility. Also use when the user mentions "YouTube SEO," "YouTube description," "YouTube tags," "YouTube thumbnail," "YouTube title," "YouTube channel," or "video SEO." For YouTube ads, use youtube-ads.
video-marketing
kostja94/marketing-skills
When the user wants to plan video marketing, create video scripts, or optimize for short-form or long-form video. Also use when the user mentions "video marketing," "video script," "short-form video," "long-form video," "TikTok script," "Reels script," "YouTube script," "video hook," or "video content strategy." For on-site video SEO, use video-optimization.
tiktok-captions
kostja94/marketing-skills
When the user wants to create TikTok video captions, scripts, or optimize for TikTok. Also use when the user mentions "TikTok post," "TikTok caption," "TikTok video," "post to TikTok," "TikTok script," "TikTok content," "TikTok copy," "TikTok hashtags," or "TikTok marketing." For TikTok ads, use tiktok-ads.
local-seo
kostja94/marketing-skills
When the user wants to optimize for local search, set up Google Business Profile, or build local citations. Also use when the user mentions "local SEO," "Google Business Profile," "Google Maps," "NAP," "citations," "local search," "local business," or "service area." For location pages, use programmatic-seo.
Popular docs & writing skills
grill-with-docs
mattpocock/skills
A relentless interview to sharpen a plan or design, which also creates docs (ADR's and glossary) as we go.
lark-markdown
open.feishu.cn
飞书 Markdown:查看、创建、上传、编辑和比较飞书中的原生 Markdown 文件。当用户要操作飞书 Markdown 文件,或比较其远端版本及本地草稿时使用。纯本地 Markdown 文件操作不触发本 skill。不负责将 Markdown 导入为飞书在线文档,也不负责文件搜索、权限、评论、移动、删除等云空间管理操作。
writing-beats
mattpocock/skills
Writing, exploit; assemble raw material into a journey of beats, grounding each term before a beat leans on it.
writing-shape
mattpocock/skills
Writing, exploit: shape raw material into an article, paragraph by paragraph.
writing-fragments
mattpocock/skills
Writing, explore: mine raw fragments, no structure yet.
writing-for-agents
mattpocock/skills
Writing documents for agents. Use when creating or editing skills, or modifying AGENTS.md or CLAUDE.md.