Blog En Review

Blog English Review Skill

This skill reviews English translations in bilingual blog posts to ensure the Japanese nuance is correctly conveyed.

Blog Format

The blog uses this structure:

---
title_ja: 日本語タイトル
title_en: English Title
desc_ja: 日本語の説明
desc_en: English description
date: YYYY-MM-DD
publish: false
---

::ja

[Japanese content - the source of truth]

::en

<!-- draft:
[User's English draft - needs review]
-->

<!-- review:
[Review notes go here]
-->

[Final English version goes here]

Review Process

Step 1: Read and Understand

1. Read the ::ja section carefully to understand the original intent
2. Read the <!-- draft: --> section to see the user's English attempt
3. Identify nuance gaps between Japanese and English

Step 2: Provide Review Notes

Add corrections to the <!-- review: --> section in this format:

- "original phrase" → "improved phrase" (reason)
- Added: [what was added and why]
- Removed: [what was removed and why]
- Nuance: [explanation of Japanese nuance that was missing]

Step 3: Generate Final Version

Write the polished English version after the review comments, preserving:

• The author's voice and style
• All links and markdown formatting
• The same paragraph structure as Japanese when possible

Review Priorities

1. Nuance accuracy: Does it convey the Japanese meaning correctly?
2. Natural English: Does it read naturally to native speakers?
3. Tone matching: Does it match the casual/formal tone of the Japanese?
4. Cultural context: Are cultural references explained if needed?

Example Review

Input (draft):

<!-- draft:
At the Tama city, there is Coffee shop, Kuroko.
The Rei-ryu, is selected at the coffee shop, is delicious.
-->

Output (review + final):

<!-- review:
- "At the Tama city" → "In Tama" (more natural preposition, no "city")
- "there is Coffee shop, Kuroko" → "there's a coffee shop called Kuroko" (article, word order)
- "The Rei-ryu, is selected" → "Reiryuu, a coffee they sell there" (clearer structure)
- "is at most for me" → "is the best I've ever had" (captures 断言できる nuance)
-->

In Tama, there's a coffee shop called Kuroko.

Reiryuu, a coffee they sell there, is absolutely exquisite—I highly recommend giving it a try.

Commands

When the user invokes this skill:

1. Ask which blog post to review (or use the one they specify)
2. Read both ::ja and ::en sections
3. Fill in <!-- review: --> with corrections
4. Write the final English version after the review section
5. Offer to update the file with the changes

File Locations

• Vault source: /Users/orangekame3/src/github.com/orangekame3/vault/blog/
• Blog content: /Users/orangekame3/src/github.com/orangekame3/orangekame3.github.io/src/content/blog/