Japanese business email checker for keigo and clarity

Checks Japanese business emails for doubled or misdirected honorifics, ra-nuki forms, missing greeting or closing, overly long sentences and ambiguous or wrong dates, then proposes fixes.

ClaudeHermes AgentCodexCursorMIT (modify, redistribute and use commercially)Python

What it does

Checks a draft email against a bundled rule list before you send it, and the agent proposes how to fix each problem.

  • Doubled honorifics (such as ossharareru, goran ni narareru, haiken sasete itadaku) and humble verbs used for the recipient's action
  • Expressions to avoid toward superiors and clients (such as gokurou-sama, ryoukai shimashita, sankou ni narimashita), onsha in writing instead of kisha, and doubled titles with sama or onchuu
  • Ra-nuki and sa-ire forms, casual words and machine-dependent characters
  • Missing addressee, greeting, self-introduction or closing line, and missing signature
  • Overly long sentences and sentences with too many commas
  • Dates whose weekday is wrong or missing, times that could be AM or PM, and vague deadlines like next week or as soon as possible

How to use

python scripts/jp_email_check.py draft.txt --recipient superior

Choose the recipient type (client, superior or peer) so only relevant rules apply. The agent lists each finding as original phrase, suggestion and reason, then gives a corrected full draft that keeps your meaning.

Requirements

  • Python 3 (standard library only)

Caveats

  • This is a pattern-based check, so it can miss problems or flag correct text. You make the final call.
  • Forms accepted by convention, such as o-ukagai suru, are not flagged.
  • Dates without a year are checked against the current year (or next year if the date would be more than 60 days in the past). Use --year to override.
  • Emails are never sent or forwarded.

How to install

  1. Unzip the downloaded file (it contains a japanese-business-email-check/ folder with SKILL.md).
  2. Copy the whole folder into your agent's skills folder.
    • Claude: ~/.claude/skills/ (per project: .claude/skills/)
    • Hermes Agent: ~/.hermes/skills/
    • Codex: ~/.agents/skills/ / Cursor: ~/.cursor/skills/
    • Claude app (claude.ai): upload the ZIP in Customize → Skills
  3. Restart the agent and check that the skill appears in its skill list.

Step-by-step install for Windows / Mac and each agent

Seller

AI Skill Market (official)

44 published skills

Seller profile and all skills