Repolode
Submit
coji

coji/natural-japanese

An Agent Skill that rewrites AI-generated Japanese work documents into natural, readable prose without adding facts or changing certainty.

View on GitHub
Stars
2,024
Forks
58
Open issues
0
Last commit
20 hours ago

What is it?

natural-japanese is an Agent Skill for Claude Code and other coding agents that edits Japanese work documents such as meeting minutes, reports, technical articles and PR descriptions. It targets the stiff, abstract phrasing that AI models often produce and rewrites it into plain, concrete Japanese.

The skill keeps the original facts, numbers, opinions and degree of certainty intact. After revising, it compares the draft with the source to check that nothing new was added. Scoring mode can rate naturalness from 0 to 100 without rewriting the text.

Detection runs through a Python script, lint.py, which uses sudachipy for morphological analysis to flag suspicious expressions. The agent then decides in context whether each one should change. Installation works through npx skills, Cursor/Codex via openskills, or the Claude Code plugin marketplace.

Key features

  • 01Rewrites AI-generated Japanese into plainer, more concrete wording
  • 02Preserves original facts, numbers, opinions and certainty levels
  • 03Flags suspicious expressions with sudachipy-based morphological analysis
  • 04Provides a 0-100 naturalness score without rewriting
  • 05Compares revised text against the original to catch added content

Use cases

  • Polishing AI-drafted meeting minutes or work reports in Japanese
  • Editing Japanese technical articles and pull request descriptions
  • Checking a Japanese document's naturalness before sending it to colleagues

Quick start

  1. 1

    Install the skill with npx

    npx skills add coji/natural-japanese
  2. 2

    Ask your agent to make a document more readable, for example by saying 読みやすくして

Things to know

  • The README says it misses about half of English-style idioms and nominalized phrasing.
  • Lowering the model's effort setting increases missed fixes, so high effort is recommended.

In collections

Claude Code tools, skills & pluginsAI agent skill librariesNatural language processing tools & librariesCode linters & formatters

Topics

#agent-skills#claude-code#japanese#writing#nlp#lint#claude#sudachipy

FAQ

What is natural-japanese?
An Agent Skill that rewrites AI-generated Japanese work documents into natural, readable prose without adding facts or changing certainty. natural-japanese is an Agent Skill for Claude Code and other coding agents that edits Japanese work documents such as meeting minutes, reports, technical articles and PR descriptions. It targets the stiff, abstract phrasing that AI models often produce and rewrites it into plain, concrete Japanese.
Is natural-japanese free to use? What license does it have?
natural-japanese is open source under the MIT license. Check the license terms before using it in commercial products.
Is natural-japanese still maintained?
Actively maintained. The last commit to natural-japanese was on Nov 6, 2026.
What can I use natural-japanese for?
Polishing AI-drafted meeting minutes or work reports in Japanese Editing Japanese technical articles and pull request descriptions Checking a Japanese document's naturalness before sending it to colleagues
How do I install natural-japanese?
Install the skill with npx: npx skills add coji/natural-japanese Ask your agent to make a document more readable, for example by saying 読みやすくして
Where can I get natural-japanese?
The source code and installation instructions are on GitHub: https://github.com/coji/natural-japanese

Summary generated by AI from the project's README. GitHub stats refresh daily.

Related projects