# natural-japanese

An Agent Skill that helps an AI coding assistant write and revise Japanese business documents so they read naturally, using a style rulebook and morphological-analysis linting.

natural-japanese is an Agent Skill for producing clear, natural Japanese in work documents such as meeting minutes, reports, internal guides and blog posts. It applies a twelve-point style constitution before writing begins, so a first draft avoids common AI-sounding patterns such as generic headings, evenly sized paragraphs and hedge-heavy conclusions, and it separately runs a script that uses the sudachipy morphological analyzer to flag remaining cliches, monotonous sentence rhythm and literal-translation phrasing.

Detection is mechanical, but deciding what to fix is left to the person or agent using the skill, since automatically replacing every flagged phrase can erase nuance. It installs into Claude Code, Cursor, Codex and other agents through a skills installer or as a Claude Code plugin, and is written in Python.

Website: https://github.com/coji/natural-japanese