Agent skill

Translate

by ai-driven-dev in ai-driven-dev/framework

Builds the canonical-source-to-target-native translation pipeline under src/contexts/translate/ — target-aware content transforms, the plugin content translator, and the build strategies behind aidd…

MITAuto-check passedWriting & Content

Install Translate

skills CLI
$ npx skills add ai-driven-dev/framework --skill translate -a claude-code

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

GitHub CLI
$ gh skill install ai-driven-dev/framework translate --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/ai-driven-dev/framework.git skills-src && mkdir -p .claude/skills && cp -r skills-src/cli/.claude/skills/translate .claude/skills/translate && 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
translate
GitHub stars
510
Token cost
~1.1k tokens
SKILL.md length
455 words
Files
1
Skills in repo
52
Repo updated
First seen
Licence
MIT

At a glance

Builds the canonical-source-to-target-native translation pipeline under src/contexts/translate/ — target-aware content transforms, the plugin content translator, and the build strategies behind aidd…

  • Adding a target-aware transform
  • SKILL.md covers What goes in, How, Public surface and How it's tested
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md
  • Changing PluginContentTranslator

What it does

Translate is an agent skill from ai-driven-dev/framework. Builds the canonical-source-to-target-native translation pipeline under src/contexts/translate/ — target-aware content transforms, the plugin content translator, and the build strategies behind aidd translate and aidd sync. Use when adding a target-aware transform, changing PluginContentTranslator, adding a build strategy, or wiring a new tool into the build registry. Do NOT use for a tool's own profile, capability classes, or build contract — use tools. Do NOT use for where content is fetched from — use…

Its SKILL.md is about 1.1k 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. The repository describes itself as: Marketplace Framework AI-Driven Dev : Context Engineering, Plugins, Agents, Skills, Hooks, Templates, SDLC. The licence is MIT.

When your agent uses it

  • Adding a target-aware transform
  • Changing PluginContentTranslator
  • Adding a build strategy
  • Wiring a new tool into the build registry

Example prompts

  • “Use the translate skill to build the canonical-source-to-target-native translation pipeline under src/contexts/translate/ — target-aware content…”
  • “/translate”

What it can do on your machine

Read from SKILL.md and the folder at commit 6e30640. 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.

    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

Translate loads about 1.1k tokens when it runs. Until then it costs about 152 tokens; SKILL.md has 455 words of instructions outside code blocks.

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

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 ai-driven-dev/framework at commit 6e30640, republished under its MIT licence (© ai-driven-dev). 455 words, ~1,114 tokens.

Download SKILL.mdSave it as .claude/skills/translate/SKILL.md (or your agent's skills folder).
name
translate
description
Builds the canonical-source-to-target-native translation pipeline under src/contexts/translate/ — target-aware content transforms, the plugin content translator, and the build strategies behind `aidd translate` and `aidd sync`. Use when adding a target-aware transform, changing `PluginContentTranslator`, adding a build strategy, or wiring a new tool into the build registry. Do NOT use for a tool's own profile, capability classes, or build contract — use `tools`. Do NOT use for where content is fetched from — use `distribution`. Do NOT use for manifest/install orchestration — use `framework`.

Translate

translate is the core: it turns the canonical, Claude-format framework source into target-native content for every tool at once. It reaches two places and no others: tools, its one outbound context edge, and kernel. Everything it reaches in tools is that context's declared public surface (contracts.ts, registry.ts, build-contract.ts, and the handful of capability and port modules listed as public), never an internal file. The whole graph is in .claude/rules/00-architecture/0-contexts.md.

What goes in

ConceptLocation
A transform whose behavior differs by target tooldomain/formats/
The plugin-files-to-installed-files translatordomain/content-translator.ts (PluginContentTranslator)
The canonical framework-doc shapedomain/canon.ts
The canonical single-plugin shapedomain/plugin-distribution.ts
Build targets and modesdomain/build-target.ts
The aidd translate use-caseapplication/translate-source.ts (FrameworkBuildUseCase)
A build orchestrator (one per mode, never per tool)application/strategies/
Schema validation for marketplace/plugin manifestsinfrastructure/schema-validator.ts

A transform used by exactly one tool profile does not belong here — it lives in that profile's own directory. A transform shared by ≥2 profiles but identical regardless of target lives in contexts/tools/domain/formats/ instead. What belongs in translate/domain/formats/ is a transform that is aware of which target it is producing for.

How

  • PluginContentTranslator takes one plugin's canonical files and one tool's AiTool<C>, and calls the tool's own rewriteContent — it does not reimplement a tool's rewrite logic, it invokes what tools declared. That function is one-way and has no inverse; the tools skill's references/content-rewrite.md says why, and names the trap an identity rewrite sets.
  • FrameworkBuildUseCase (aidd translate) reads a ToolBuildContract per target and mode from tools, and dispatches to MarketplaceBuildStrategy or FlatBuildStrategy — both implement BuildOutputStrategy and iterate the six artifact kinds generically, with zero per-tool or per-kind branching. Adding a build target means the target tool declares a contract in tools; it never means adding a case here. See the tools skill's references/build-contract.md.
  • runtime/wiring/translate.ts derives the "<target>:<mode>" build registry by iterating every registered tool and reading its contract — there is no hand-maintained per-tool row.
  • Follow the use-case and orchestration rules in .claude/rules/00-architecture/ for the application layer's shape, and the shared-module rule there before promoting a helper used by only one strategy into shared-plugin-helpers.ts.
Show full SKILL.md (117 more words)Show less

Public surface

Nothing outside contexts/translate/ may import a module this context has not declared public — tests/architecture/context-boundary.arch.test.ts holds the list (PUBLIC_MODULES.translate). framework is the only context that imports from here (framework → translate); a module used by framework must be on that list.

How it's tested

  • tests/contexts/translate/ mirrors src/contexts/translate/ — formats, content-translator, canon, and the two build strategies each have unit or integration coverage.
  • tests/golden/framework-build-golden.e2e.test.ts snapshots a full build across every target — see test skill's golden/machine-independence rules before touching a snapshot.
  • A new target-aware transform gets a unit test over a representative input carrying the marker it is meant to rewrite. A transform that is the identity for the fixture it was given is indistinguishable from one that never ran.

© ai-driven-dev, 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 cli/.claude/skills/translate of ai-driven-dev/framework.

Open the folder on GitHubat commit 6e30640

Compare with similar skills

Translate 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.

Translate compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Translate this skillai-driven-dev/framework510—~1.1kAutomated safety check: PassMIT
Translation Diff ExportDevolutions/UniGetUI26k—~1.1kAutomated safety check: PassMIT
Sync Translationssymfony/symfony31k—~1.9kAutomated safety check: PassMIT
Translation Diff ImportDevolutions/UniGetUI26k—~750Automated safety check: PassMIT
Translation Diff TranslateDevolutions/UniGetUI26k—~934Automated safety check: PassMIT
Generate Translationspayloadcms/payload45k—~1.1kAutomated safety check: PassMIT

Similar skills

  • Translation Diff Export

    Devolutions/UniGetUI

    Compares UniGetUI JSON locale files against English, identifies untranslated or source-changed keys, and generates patch, reference, and handoff files for a target language.

    26k GitHub stars~1.1k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Sync Translations

    symfony/symfony

    Synchronize translation catalogs across maintained Symfony branches: find messages that newer branches added to the English catalogs but that are still missing from the oldest maintained branch…

    31k GitHub stars~1.9k tokensUpdated today
    Writing & ContentAuto-check passed
  • Translation Diff Import

    Devolutions/UniGetUI

    Merges translated key-value pairs from a UniGetUI JSON localization patch back into the full language file and validates the merged result.

    26k GitHub stars~750 tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Translation Diff Translate

    Devolutions/UniGetUI

    Translates a sparse UniGetUI JSON language patch, writes completed entries into the working copy, preserves placeholders and terminology, and prepares the patch for merge-back.

    26k GitHub stars~934 tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Generate Translations

    payloadcms/payload

    A skill your agent uses when new translation keys are added to packages to generate new translations strings

    45k GitHub stars~1.1k tokensUpdated today
    Writing & ContentAuto-check passed
  • Drives long-form fiction, scripts, storyboards, interactive films and long-document translation through InkOS, with every change made by a typed action.

    10k GitHub starsUsed in 1 repo~1.1k tokens
    Writing & ContentAuto-check passed

More from ai-driven-dev/framework

All 52 skills in this repo
  • 00 Async Dev

    ai-driven-dev/framework

    Drive the async-dev pipeline from one entry point, whether setup, run, or review.

    510 GitHub stars~2.4k tokensUpdated today
    Auto-check passed
  • 01 Plan

    ai-driven-dev/framework

    Turn a request, ticket, or file into a phased implementation plan.

    510 GitHub stars~517 tokensUpdated today
    Auto-check passed
  • 01 Sdlc

    ai-driven-dev/framework

    Autonomously orchestrates a request from framing to a draft pull request, isolating implementation, independent review, and final outcome challenge.

    510 GitHub stars~583 tokensUpdated today
    Auto-check passed
  • 02 Backlog

    ai-driven-dev/framework

    Orchestrates a product backlog end to end. An agent skill from ai-driven-dev/framework.

    510 GitHub stars~613 tokensUpdated today
    Auto-check passed
  • 00 Onboard

    ai-driven-dev/framework

    Guide a project's journey through AIDD, from first setup to shipping a feature.

    510 GitHub stars~242 tokensUpdated today
    Auto-check passed
  • 01 Acceptance QA

    ai-driven-dev/framework

    Validate a reviewed candidate's observable behavior against its acceptance criteria and record short named videos as reviewer evidence.

    510 GitHub stars~434 tokensUpdated today
    Auto-check passed

Questions about Translate

What does Translate do?

Builds the canonical-source-to-target-native translation pipeline under src/contexts/translate/ — target-aware content transforms, the plugin content translator, and the build strategies behind aidd…. Translate is an agent skill from ai-driven-dev/framework. Builds the canonical-source-to-target-native translation pipeline under src/contexts/translate/ — target-aware content transforms, the plugin content translator, and the build strategies behind aidd translate and aidd sync.

When should I use Translate?

Translate fits situations like: adding a target-aware transform; changing PluginContentTranslator; adding a build strategy; wiring a new tool into the build registry.

How do I install Translate in Claude Code?

Run `npx skills add ai-driven-dev/framework --skill translate -a claude-code`. Or copy the skill folder (cli/.claude/skills/translate in ai-driven-dev/framework) into .claude/skills/translate in your project. Claude Code loads it when a task matches its description.

How do I install Translate in Codex?

Run `npx skills add ai-driven-dev/framework --skill translate -a codex`. Or copy the skill folder (cli/.claude/skills/translate in ai-driven-dev/framework) into .agents/skills/translate in your project. Codex loads it when a task matches its description.

Can I use Translate 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 ai-driven-dev/framework --skill translate -a cursor` (or -a gemini-cli, github-copilot or opencode for the others). To copy it by hand, put the folder in .cursor/skills/translate, .gemini/skills/translate, .github/skills/translate and .opencode/skills/translate in your project.

What does Translate need to run?

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

Does Translate 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 Translate 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 Translate use?

Translate is published under the MIT licence (the repository's licence). It allows redistribution, so the full SKILL.md is shown on this page.

How many tokens does Translate use?

About 1.1k tokens (SKILL.md is roughly 4.5k 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 Translate?

Skills that share tags, products or a category with Translate: Translation Diff Export (Devolutions/UniGetUI, 26k stars), Sync Translations (symfony/symfony, 31k stars), Translation Diff Import (Devolutions/UniGetUI, 26k stars) and Translation Diff Translate (Devolutions/UniGetUI, 26k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Translate?

ai-driven-dev (a GitHub organization) maintains it in ai-driven-dev/framework, which has 510 GitHub stars. The repository holds 52 skills in this directory. The repository was last updated on October 7, 2026.

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