Agent skill

Po Translate

by natsukium in natsukium/dotfiles

Orchestrate English→Japanese translation of po/ja.po — classify, delegate translation/review to subagents, iterate until clean

CC0-1.0Auto-check passedWriting & Content

Install Po Translate

skills CLI
$ npx skills add natsukium/dotfiles --skill po-translate -a claude-code

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

GitHub CLI
$ gh skill install natsukium/dotfiles po-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/natsukium/dotfiles.git skills-src && mkdir -p .claude/skills && cp -r skills-src/.claude/skills/po-translate .claude/skills/po-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
po-translate
GitHub stars
106
Token cost
~1.4k tokens
SKILL.md length
457 words
Files
4 (incl. references)
Skills in repo
10
Repo updated
First seen
Licence
CC0-1.0

At a glance

Orchestrate English→Japanese translation of po/ja.po — classify, delegate translation/review to subagents, iterate until clean

  • Works in 4 steps: Classify (do this yourself) → Translate (delegate to subagents) → Review (delegate to subagent) → …
  • Tasks that involve Translation
  • SKILL.md covers Phase 1: Classify (do this…, Phase 2: Translate (delegate…, Phase 3: Review (delegate to… and Phase 4: Iterate (do this…, plus 1 more section
  • Instructions only: no scripts, shell commands, URLs or credentials in SKILL.md

What it does

Po Translate is an agent skill from natsukium/dotfiles. Orchestrate English→Japanese translation of po/ja.po — classify, delegate translation/review to subagents, iterate until clean

Its SKILL.md is about 1.4k tokens, which your agent loads only when the skill is triggered. The skill folder holds 4 other files, including reference files (for example `references/glossary.md`, `references/po-format.md` and `references/style-guide.md`).

It sits in Writing & Content, covering Translation and Subagents. The repository describes itself as: Nix dotfiles for NixOS, Darwin and WSL. The licence is CC0-1.0.

When your agent uses it

  • Tasks that involve Translation
  • Tasks that involve Subagents

Example prompts

  • “/po-translate”

Workflow steps

4 steps, taken from the step headings in SKILL.md.

  1. Classify (do this yourself)
  2. Translate (delegate to subagents)
  3. Review (delegate to subagent)
  4. Iterate (do this yourself)

What it can do on your machine

Read from SKILL.md and the folder at commit 31561dd. 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 bash).

    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

Po Translate loads about 1.4k tokens when it runs, and up to ~5.8k if it reads all its reference files. Until then it costs about 35 tokens; SKILL.md has 457 words of instructions outside code blocks.

Always · name and description, kept in context so the agent knows when to use it
~35
When it runs · the whole SKILL.md, loaded when a task matches
~1.4k
With references · SKILL.md plus every file in references/, read only if the agent opens them
~5.8k

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 natsukium/dotfiles at commit 31561dd, republished under its CC0-1.0 licence (© natsukium). 457 words, ~1,442 tokens.

Download SKILL.mdSave it as .claude/skills/po-translate/SKILL.md (or your agent's skills folder). This skill also uses 3 other files; get the full folder from GitHub.
name
po-translate
description
Orchestrate English→Japanese translation of po/ja.po — classify, delegate translation/review to subagents, iterate until clean

PO Translation Orchestrator

Translate po/ja.po from English to Japanese for this literate Nix configuration repository. This skill orchestrates the process: you classify entries yourself, then delegate translation and review to subagents, iterating until the review passes.

Phase 1: Classify (do this yourself)

Scan po/ja.po and classify every entry into three buckets.

Skip (leave msgstr empty)
PO type comment (#. type:)Reason
paragraph in srcCode block content
keyword NAME / keyword nameSource block identifiers
keyword SETUPFILEOrg directive
keyword PROPERTYProperty drawer value
keyword OPTIONSExport option string
keyword STARTUPStartup keyword
keyword INCLUDEpo4a handles path swap
property (*)Property values

Also skip: bare URLs as msgid, table cells with hardware models/hostnames/platforms.

Already Translated

Non-empty msgstr — leave unchanged unless review flags them.

Translate

Everything else: paragraph, heading *–*****, plain list, paragraph in QUOTE/quote/example, cell column N with prose, keyword title.

Grouping

Group translatable entries by primary source file into sequential batches:

  1. configuration.org
  2. applications/emacs/init.org
  3. overlays/configuration.org + applications/emacs/early-init.org + .github/README.org
  4. modules/configuration.org

Output a batch summary (entry counts, line ranges) before proceeding to Phase 2.

Phase 2: Translate (delegate to subagents)

Spawn one Agent per batch, sequentially (wait for each to finish before starting the next — they all edit the same file).

Subagent prompt template

Include ALL of the following in each subagent's prompt:

  1. The batch assignment: line range, list of msgid start lines to translate
  2. The full content of these reference files (read them yourself first, then paste the content into the prompt — subagents cannot read skill reference files by path):
    • .claude/skills/po-translate/references/glossary.md
    • .claude/skills/po-translate/references/style-guide.md
    • .claude/skills/po-translate/references/po-format.md
  3. These rules:
## Translation Rules

### What to translate
- paragraph, heading, plain list, paragraph in QUOTE/quote/example, cell with prose, keyword title

### What to leave empty (msgstr "")
- paragraph in src, keyword NAME/name, SETUPFILE/PROPERTY/OPTIONS/STARTUP/INCLUDE, property (*), bare URLs, proper nouns (hardware models, hostnames, platforms)

### PO format
- #, no-wrap entries: msgstr on single line
- Multi-line msgid: msgstr starts with "" then continuation lines
- Match approximate line structure of msgid
- Preserve \" escaping

### Org markup preservation
- [[url][desc]]: translate only desc, keep URL intact
- [[*heading][desc]]: translate *heading to match the translated heading name in po/ja.po, translate desc independently
- =code= and ~verbatim~: do NOT translate content inside markers
- *bold* / /italic/: translate text, keep markers
- \\\\: preserve in same position

### Terminology
- Follow the glossary strictly
- Nix terms (flake, derivation, overlay, home-manager) → keep English
- General technical terms with Japanese equivalents → use Japanese

### Register
- です/ます (desu/masu) polite form consistently
- Technical but accessible
- Faithfully translate "why" reasoning — core value of literate config

### Important
- Never modify msgid or comment lines (#., #:, #,)
- If entry already has correct translation, leave unchanged
- Preserve blank lines between entries
- Use the Edit tool for each translation
- After completing, read back modified sections to verify

Phase 3: Review (delegate to subagent)

After all translation batches complete, spawn a review subagent.

Show full SKILL.md (185 more words)Show less
Review subagent prompt

Include these checks in the prompt:

  1. PO Syntax: Run msgfmt --check po/ja.po
  2. Code blocks empty: Verify paragraph in src, keyword NAME/name, directive keywords, property (*) all have empty msgstr
  3. Prose translated: Verify paragraph, heading, plain list etc. have non-empty msgstr
  4. No-wrap compliance: #, no-wrap entries have single-line msgstr
  5. Terminology: No "フレーク"/"デリベーション"/"オーバーレイ" (should stay English); "configuration"→"設定", "declarative"→"宣言的" consistently
  6. Markup: [[/]] count matches, URLs unchanged, =code=/~verbatim~ preserved
  7. Internal links: [[*heading][desc]] — verify *heading matches the translated heading name in the corresponding heading entry's msgstr
  8. Register: Sample entries for consistent です/ます form
  9. Japanese prose norms: No em dash or 中黒-enumeration introduced in msgstr; no LLM-ish filler (「重要なのは」「掘り下げる」etc. — see style-guide.md); hedging level matches the English msgid

The review subagent should:

  • Fix minor issues (structural/terminology) directly
  • Report translation quality issues with line numbers
  • Re-run msgfmt --check po/ja.po after fixes

Phase 4: Iterate (do this yourself)

Evaluate the review subagent's report:

  • If PASS on all checks → done
  • If issues remain → spawn targeted translation subagents to fix only the flagged entries, then re-run review (Phase 3)
  • Repeat until clean

Final Validation

After review passes:

sh
msgfmt --check po/ja.po
po4a po4a.cfg

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

Files

SKILL.md and 3 other files (references) in .claude/skills/po-translate of natsukium/dotfiles.

  • SKILL.md
  • references/glossary.md
  • references/po-format.md
  • references/style-guide.md

Open the folder on GitHubat commit 31561dd

Compare with similar skills

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

Po Translate compared with similar skills
SkillStarsUsed inTokensAuto-checkLicenceRepo updated
Po Translate this skillnatsukium/dotfiles106—~1.4kAutomated safety check: PassCC0-1.0
Benchmark Translateshapeshift/web206—~1.6kAutomated safety check: PassMIT
Translateforthecraft/drf-auth-kit121—~2.4kAutomated safety check: NotesMIT
Docs Leadlablup/backend.ai-webui133—~2.9kAutomated safety check: PassLGPL-3.0
Translate Bookdeusyu/translate-book2.1k—~5.5kAutomated safety check: NotesMIT
China Travel Kittczyliu/china-travel-kit194—~1.3kAutomated safety check: PassMIT

Similar skills

  • Benchmark Translate

    shapeshift/web

    Run a quality benchmark of the /translate skill by selecting stratified test keys, capturing ground truth, translating, judging with sub-agents, and compiling a regression report.

    206 GitHub stars~1.6k tokensUpdated yesterday
    Writing & ContentAuto-check passed
  • Translate

    forthecraft/drf-auth-kit

    Run Django translation workflow - extract untranslated strings, translate them to 59 languages using parallel translator subagents, and apply back to PO files.

    121 GitHub stars~2.4k tokensUpdated 2 mo ago
    Writing & ContentAuto-check: notes
  • Docs Lead

    lablup/backend.ai-webui

    A skill your agent uses whenever the user mentions docs, the manual, documentation, terminology, translations, or screenshots — including indirect mentions like "이 PR 문서 영향 봐줘", "문서 점검", "용어 통일"…

    133 GitHub stars~2.9k tokensUpdated today
    Writing & ContentAuto-check passed
  • Translate Book

    deusyu/translate-book

    Translate books (PDF/DOCX/EPUB) into any language using parallel sub-agents.

    2.1k GitHub stars~5.5k tokensUpdated 17 days ago
    Documents & OfficeAuto-check: notes
  • China Travel Kit

    tczyliu/china-travel-kit

    Research and plan first-time independent trips in China with bilingual, source-aware city data and official live-check entry points.

    194 GitHub stars~1.3k tokensUpdated 1 mo ago
    Writing & ContentAuto-check passed
  • Ainiee Next Translation

    ShadowLoveElysia/AiNiee-Next

    在用户要求翻译小说、文档、字幕或其他文件内容时,按 AiNiee-Next 的输入优先、长文本询问和 MCP 边界执行;进入 AiNiee 工作流后,原文获取与术语预分析也必须走受控读取工具,禁止自行解包解析。

    177 GitHub stars~3.3k tokensUpdated today
    Writing & ContentAuto-check passed

More from natsukium/dotfiles

All 10 skills in this repo
  • Pi Review

    natsukium/dotfiles

    Delegate a source-grounded design or code review to a fresh pi CLI process using sol or luna, then address verified findings until no blockers remain.

    106 GitHub stars~972 tokensUpdated today
    Auto-check passed
  • Attmcojp Claude Md

    natsukium/dotfiles

    Change the org-level CLAUDE.md that governs every attmcojp repository.

    106 GitHub stars~1.3k tokensUpdated today
    Auto-check: notes
  • Ghq

    natsukium/dotfiles

    Clone and reuse GitHub/GitLab repositories under a single managed root (ghq root) instead of fetching files one-by-one via gh api/WebFetch or scratch-cloning into /tmp.

    106 GitHub stars~1.2k tokensUpdated today
    Auto-check passed
  • Gui Debug

    natsukium/dotfiles

    Verify a rendering or window-chrome change in any macOS GUI app unattended — find its CGWindowID via JXA, capture that window alone (with per-pixel alpha) using screencapture -l, and read exact RGBA…

    106 GitHub stars~909 tokensUpdated today
    Auto-check passed
  • Gui Debug

    natsukium/dotfiles

    Verify a rendering or window-chrome change in a GUI app unattended on Linux/Wayland under the niri compositor — enumerate windows and read output scale via niri msg --json, capture a specific window…

    106 GitHub stars~1.1k tokensUpdated today
    Auto-check passed
  • Gh

    natsukium/dotfiles

    GitHub CLI for pull requests, issues, releases, workflows, and repository operations.

    106 GitHub stars~422 tokensUpdated today
    Auto-check passed

Questions about Po Translate

What does Po Translate do?

Orchestrate English→Japanese translation of po/ja.po — classify, delegate translation/review to subagents, iterate until clean. Po Translate is an agent skill from natsukium/dotfiles.

When should I use Po Translate?

Po Translate fits situations like: tasks that involve Translation; tasks that involve Subagents.

How do I install Po Translate in Claude Code?

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

How do I install Po Translate in Codex?

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

Can I use Po 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 natsukium/dotfiles --skill po-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/po-translate, .gemini/skills/po-translate, .github/skills/po-translate and .opencode/skills/po-translate in your project.

What does Po Translate need to run?

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

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

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

How many tokens does Po Translate use?

About 1.4k tokens (SKILL.md is roughly 5.8k characters). Agents keep only the skill's name and description in context until a task matches; then they load SKILL.md in full. Its references folder adds about 4.3k tokens, read only when the agent opens those files.

What are the alternatives to Po Translate?

Skills that share tags, products or a category with Po Translate: Benchmark Translate (shapeshift/web, 206 stars), Translate (forthecraft/drf-auth-kit, 121 stars), Docs Lead (lablup/backend.ai-webui, 133 stars) and Translate Book (deusyu/translate-book, 2.1k stars). The comparison table on this page puts their stars, adoption, token cost, safety result and licence side by side.

Who maintains Po Translate?

natsukium (a GitHub user) maintains it in natsukium/dotfiles, which has 106 GitHub stars. The repository holds 10 skills in this directory. The repository was last updated on October 10, 2026.

Source: natsukium/dotfiles on GitHub. Facts on this page come from the repository at the commit we read; the author's words are quoted as theirs.