README 4-file synchronization procedure for the oss-docs harness: English README.md as primary source, ko/ja/zh derivation, the shared language-switcher header contract, section-order parity checklist, and the manual verification recipe (no linter exists for READMEs). Loaded by the content-author and locale-translator specialists for any README work.
SkillScore95Maintained
Automatic
◆Translation & Localization pack
Last verified 8/27/2026
What it changes
Passed 20 of 21 test cases with the skill, and 7 of 21 without it.
Without skill32%
With skill95%
Checks it passed that the model alone missed
Includes docs.moai-ai.dev in the URL blacklist check
Specifies README.zh.md as the Chinese derived README file name
Designates README.ko.md as the initial target for setup guide edits
and 17 more in the full report
14 fixed7 passed either way1 still failing0 broke
Pass-rate lift
+64 pp
Tokens
+6%
Agent turns
0%
Response time
-48%
Model gemini-3.6-flashMeasured 8/27/2026v221 of 22 cases passed with skill · 21 comparable
Tokens, turns and time describe resource use, not a dollar price.
See it in action
One of 14 test cases the skill fixed. Same model, same prompt, with and without the skill.
1 of 14
Prompt
Besides checking that H2 heading counts match across all four README files, what structural check must be performed regarding H2 headings?
What was checked, without and with the skill
Checked
Without skill
With skill
Requires verifying that H2 section ordering in derived files matches the canonical Korean file section order
Missed
Passed
case-20 · gemini-3.6-flash · 8/27/2026 · answers are capped and redacted
What's inside
The instructions your model reads when the skill loads.
SKILL.md70 linessingle file
README 4-File Sync Procedure
The GitHub-facing README set is 4 files at the repo root:
File
Locale
Role
README.ko.md
ko
canonical / primary — author here first
README.md
en
derived
README.ja.md
ja
derived
README.zh.md
zh
derived
Chain history: the canonical locale was English until 2026-08-17, when
card t47 promoted the ko new-skeleton (feature-oriented section structure)
to canonical per the operator decision — aligning the README chain with the
docs-site chain, which was already ko-canonical. The former en-skeleton
redesign reference (.moai/reports/readme-docs-redesign-20260713.md) is
superseded by the ko skeleton and kept as history only.
Procedure
Author the change in README.ko.md (Korean) only. Respect the
canonical ko section skeleton; keep the file length in the range of the
current set.
Derive en, ja, zh — same PR, one derived file per translator worker.
Translate the changed sections minimally; do not rewrite untouched prose.
Preserve verbatim across all 4 files: code blocks, command names,
badges, version strings, file paths, tables' structure, Mermaid direction,
and the switcher header (below).
Verify parity (checklist below) before returning.
Language-switcher header contract [HARD]
All 4 files share the same switcher header near the top, linking the sibling
files with the label set exactly:
English · 한국어 · 日本語 · 中文
The current file's own label renders as plain text; the other 3 are links