Repolode
Submit
nanaism

nanaism/yomiyasu

An Agent Skill that rewrites AI-generated Japanese into more natural, readable Japanese for technical articles, specs, and PR descriptions.

View on GitHub
Stars
2,896
Forks
75
Open issues
1
Last commit
2 days ago

What is it?

yomiyasu is a Japanese text-editing skill for AI coding agents such as Claude Code, Codex and Cursor. It targets awkward phrasing typical of AI-generated Japanese: metaphorical verbs, ambiguous subject-predicate relations, unnecessary decoration and bold text, and over-formatted lists. It is designed mainly for practical writing such as technical articles, design and specification documents, PR descriptions and internal reports.

The skill keeps the original meaning, claims and emphasis, and avoids adding facts that are not in the source. When a value or subject cannot be settled from the text, it is flagged for the author to confirm rather than guessed. Document type and reader familiarity can be specified in the request to adjust the rewrite.

The repository also includes Python standard-library tools: a lint script for expression and formatting issues, a diff script that highlights changes to numbers, negation and particles, and a check script that combines both and records the results. Installation is possible through npx skills, the GitHub CLI, openskills, a Claude Code plugin, or by copying the skill folder into a repository.

Key features

  • 01Rewrites metaphorical verbs and unclear subject-predicate structures into plainer Japanese.
  • 02Preserves the original meaning, claims and assertion strength instead of adding facts.
  • 03Flags ambiguous values or subjects for the author to confirm.
  • 04Includes a lint script for expression and formatting issues.
  • 05Includes a diff script that highlights changes to numbers, negation and particles.

Use cases

  • Polishing AI-drafted technical articles before publishing in Japanese.
  • Cleaning up Japanese design documents, specifications or PR descriptions.
  • Revising internal reports written with an AI assistant.

Quick start

  1. 1

    Clone the repository and install the skill with npx

    npx skills add nanaism/yomiyasu
  2. 2

    Ask your AI coding agent to use yomiyasu on a draft, e.g. write the request with the name yomiyasu in it

Things to know

  • The skill is designed for Japanese text only and is not useful for other languages.
  • Its output depends on the AI agent that runs it, and results can vary.
  • Some installation methods (such as Claude.ai ZIP upload or Codex repository copy) require manual steps.

In collections

Claude Code tools, skills & pluginsAI coding assistants & agentsAI agent skill librariesCode linters & formatters

Topics

#japanese#ai-writing#agent-skills#writing-assistant#linter#llm#antigravity#claude-code#codex#cursor

FAQ

What is yomiyasu?
An Agent Skill that rewrites AI-generated Japanese into more natural, readable Japanese for technical articles, specs, and PR descriptions. yomiyasu is a Japanese text-editing skill for AI coding agents such as Claude Code, Codex and Cursor. It targets awkward phrasing typical of AI-generated Japanese: metaphorical verbs, ambiguous subject-predicate relations, unnecessary decoration and bold text, and over-formatted lists. It is designed mainly for practical writing such as technical articles, design and specification documents, PR descriptions and internal reports.
Is yomiyasu free to use? What license does it have?
yomiyasu is open source under the MIT license. Check the license terms before using it in commercial products.
Is yomiyasu still maintained?
Actively maintained. The last commit to yomiyasu was on Nov 6, 2026.
What can I use yomiyasu for?
Polishing AI-drafted technical articles before publishing in Japanese. Cleaning up Japanese design documents, specifications or PR descriptions. Revising internal reports written with an AI assistant.
How do I install yomiyasu?
Clone the repository and install the skill with npx: npx skills add nanaism/yomiyasu Ask your AI coding agent to use yomiyasu on a draft, e.g. write the request with the name yomiyasu in it
Where can I get yomiyasu?
The source code and installation instructions are on GitHub: https://github.com/nanaism/yomiyasu

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

Related projects