translate-news-ko

Imported from riseshia/dotfiles (plugins/misc/skills/translate-news-ko/SKILL.md). Install upstream with npx skills add riseshia/dotfiles --skill translate-news-ko. Copyright stays with the author.

Translate English News to Korean

You are a skill that translates English Ruby news articles to Korean for the ruby-lang.org website.

Workflow

Follow these steps in order:

1. Get the file path from the user

   • Ask the user which English news file they want to translate
   • The file should be in the format: en/news/_posts/YYYY-MM-DD-title.md

2. Read the file and create a branch

   • Read the English news file
   • Extract the article title from the frontmatter
   • Create an appropriate branch name based on the title (e.g., tr-ruby-3-4-7-ko)
   • Switch to the new branch: git checkout -b {branch_name}

3. Copy the file to Korean directory

   • Copy the file from en/news/_posts/ to ko/news/_posts/ with the same filename
   • Example: cp en/news/_posts/2025-10-07-ruby-3-4-7-released.md ko/news/_posts/2025-10-07-ruby-3-4-7-released.md
   • Commit this change with message: cp {en,ko}/news/_posts/2025-10-07-ruby-3-4-7-released.md

4. Translate the article

   • Read recent Korean news translations to understand the style and terminology:
     • Check 3-5 recent files in ko/news/_posts/
     • Note common terms and their translations
   • Translate the article following these rules:
     • Keep the same line count as the original so the en/ko diff stays readable. A sentence that spans several source lines can be translated as one unit and re-split to match.
     • Use consistent terminology from past translations
     • Maintain a formal but friendly tone
     • Keep proper nouns in English (e.g., Ruby, RubyGems, Bundler)
     • Translate technical terms consistently:
       • "release" → "릴리스"
       • "bug fix" → "버그 수정"
       • "security" → "보안"
       • "vulnerability" → "취약점"
       • "recommend" → "권장합니다"
       • "contribution" → "기여"
     • Update the frontmatter:
       • Change lang: en to lang: ko
       • Add translator: "shia"
       • Translate the title field to Korean
       • Keep other fields unchanged

5. Verify line count matches original

   • Compare line counts: wc -l en/news/_posts/{filename} ko/news/_posts/{filename}
   • If line counts don't match, adjust the translation to match

6. Grammar check with hanspell-cli

   • Run: cat ko/news/_posts/{filename} | hanspell-cli
   • Review and apply suggested corrections
   • Make any necessary adjustments

7. Commit the translation

   • Commit the translated file with message: Translate "{article title}" (ko)
   • Include the Claude Code footer in commit message
   • If you made changes after the initial commit (e.g., line count adjustments), amend the commit

8. Push and provide PR URL

   • Push the branch: git push -u origin {branch_name}
   • Extract the PR creation URL from the git push output
   • Provide the user with:
     • The PR creation URL
     • PR title (use the last commit message)
     • PR body template:

       :link: https://github.com/ruby/www.ruby-lang.org/issues/3461
       Translation of: https://github.com/ruby/www.ruby-lang.org/blob/master/en/news/_posts/{filename}
       Actual diff is: {last_commit_hash}
       

   • DO NOT use gh pr create --web, just provide the URL and information

Important Notes

• Always check existing translations for consistent terminology
• Preserve all markdown formatting, links, and code blocks
• Keep the date format unchanged in the frontmatter
• Do not translate URLs or file paths
• The translation should sound natural in Korean while maintaining technical accuracy