maintain-japanese-references

Synchronize Japanese reference translations with changed English canonical repository documents.

Updated May 12, 2026
One-click install
npx skills add https://github.com/mtk177a/skills --skill maintain-japanese-references-mtk177a
Or copy as Structured Prompt for Agent▼
Please help me install this Agent Skill.
Skill: maintain-japanese-references
Source: https://github.com/mtk177a/skills/tree/main/.agents/skills/maintain-japanese-references
Command: npx skills add https://github.com/mtk177a/skills --skill maintain-japanese-references-mtk177a

SYSTEM DOCUMENTATION & REQUIREMENTS

What problem does it solve? When English canonical files in a repository change, their maintained Japanese reference translations can silently drift out of sync, or receive unnecessary no-op edits that create review churn. This Skill decides, per maintained file pair, whether a Japanese translation must be created, updated, or explicitly left unchanged. ## Core Features & Use Cases - Pair-scoped maintenance: Covers defined pairs such as README.md → README.ja.md, AGENTS.md → AGENTS-ja.md, docs/<name>.md → docs/ja/<name>.md, and SKILL.md → SKILL-ja.md for English-canonical Skills. - Semantic-impact judgment: Distinguishes meaning-bearing changes (requirements, scope, exceptions, permissions, procedures, links) from non-semantic edits like whitespace reflow, avoiding no-op translation churn. - Fidelity and terminology preservation: Retains normative force (must/should/may), frontmatter fields, headings, links, code, and established repository terminology without adding content absent from the canonical source. - Use Case: After editing an English SKILL.md to strengthen a requirement from 'should' to 'must', run this Skill to update the corresponding SKILL-ja.md while leaving unrelated translations untouched and reporting the semantic reason. ## Quick Start Review the current diff and create or update the maintained Japanese reference translations for any changed English canonical files, reporting which pairs were updated or left unchanged and why.

Frequently Asked Questions about maintain-japanese-references

High-intent search queries and answers about installing and using this skill.

FAQPage Schema
How do I keep Japanese translations in sync with English documentation?▼

Identify changed English canonical files in the maintained pairs, judge whether each change affects meaning for Japanese readers, and update only the affected translations in the same change. Non-semantic edits like whitespace reflow should leave the Japanese file untouched with a recorded reason.

Which file pairs does Japanese translation maintenance cover?▼

It covers README.md to README.ja.md, AGENTS.md to AGENTS-ja.md, CLAUDE.md to CLAUDE-ja.md, docs/<name>.md to docs/ja/<name>.md, and SKILL.md to SKILL-ja.md for English-canonical Skills, including tracked repository-local Skills under .agents/skills.

When should a Japanese translation not be created or updated?▼

Do not create translations for documented Japanese-canonical Skills, and do not update a translation when the English change is non-semantic, such as source-line reflow. Also exclude Issue or pull-request authoring and general translation outside the maintained pairs.

How are ambiguous translations or terminology handled?▼

Prefer terminology already established in the repository's Japanese references and never add explanations or claims absent from the canonical source. If the canonical meaning or an established translation is materially ambiguous, report the affected pair and ambiguity instead of guessing.

Can this workflow edit the English canonical source or use translation services?▼

No. The English canonical source is never edited as part of translation maintenance, and no external translation service or new dependency is used. Commits, pushes, tracker posts, and subagent launches also require separate authorization.