repo-bilingual-readme
Installation
SKILL.md
Repository English–Chinese Edition
Scope and source preservation
Create a faithful English–Chinese reading edition in the repository, not a summary or a rewritten survey. These defaults capture this user's established preferences; explicit current instructions override them.
- Keep upstream English files unchanged by default. Create or maintain
README_zh-CN.md; for another requested document use a sibling such asnot-good-ideas_zh-CN.md, following its actual basename and existing repository convention. Inspect existing files before choosing names; do not duplicate an existing bilingual edition. - Cover every document explicitly requested, including non-README Markdown files. Do not translate unrelated files just because they are in the repository.
- Resolve owner, repository, branch, path, and source revision from the actual repository. Inspect the current bilingual file, git status, and relevant diffs before editing; preserve user changes.
- Preserve English wording, technical meaning, links, images, citations, code, and licenses. Translate all reader-facing prose without omitting paragraphs or replacing them with summaries. Do not alter executable examples to make them bilingual.
- A separate bilingual file reduces collisions with upstream README edits, but does not automatically synchronize translations or eliminate all merge conflicts. For later updates, compare source revisions and reconcile changes into the bilingual edition; never blindly overwrite it.
- If the source revision used for an earlier edition is unknown, audit against the complete current source rather than assuming a partial diff proves completeness. Keep provenance in working notes or an existing maintenance convention, not intrusive metadata added without need.
Layout defaults
Headings and contents entries use English + exactly one ordinary ASCII space + Chinese on the same line. Apply this to every heading depth, including tertiary taxonomy categories, not just the table of contents. Do not use /, |, a dash, a line break, or a full-width space as the language separator. Preserve punctuation that genuinely belongs to the source title.