Yomiyasu Skill: Fix Stiff, AI-Written Japanese Text with Claude

Makes Claude rewrite AI-generated Japanese so it reads naturally, fixing odd metaphors and unclear subjects without changing the meaning.

Installs: 16.2K; on skills.sh
Stars: 2.8K; on GitHub
Files: 42; besides SKILL.md
Updated: Oct 2026; last repo commit

Yomiyasu (よみやす) makes Claude edit Japanese text that an AI wrote. It fixes unnatural metaphors, vague subjects and objects, personified tools and decorative bold or bullets, while keeping the meaning, conditions and the writer's style. Its main targets are tech articles, specs, PR descriptions and internal reports.

It only starts when you name it, for example by asking to polish a draft with yomiyasu, and it works in Japanese. After rewriting, it saves the final draft as a new file, runs its bundled Python check script, and tells you what it changed and what it left alone.

Good for

Engineers who write Japanese tech articles, specs or PR descriptions with AI
Teams that review Japanese reports and mail drafts written by AI
Anyone who reads and edits Japanese, since the skill works in Japanese

Install yomiyasu

Claude Code

Copy this prompt.

Install the yomiyasu skill in Claude Code. Run this command:

npx skills add nanaism/yomiyasu

Then check that it loaded and tell me how to use it.

2
Paste it into Claude Code. It shows the change and asks before running it.

Requires Node.js.

yomiyasu stands alone and has no sibling skills. It only starts when you name it. The installed name depends on the route: yomiyasu for npx skills, gh skill and openskills installs in Claude Code, yomiyasu:yomiyasu for the Claude Code plugin and in Codex (the skill folder holds a Codex plugin file). It needs Python 3 for its check scripts. The README says the author verified rewrites only with claude -p and codex exec on macOS. Pick one route. After the plugin install, call it as yomiyasu:yomiyasu; plain yomiyasu can give Unknown skill.

From the project README. Source.

What's in the skill

When it loads

AIが生成した日本語を推敲するスキル。利用者が yomiyasu の名前を出して頼んだとき（「/yomiyasu」、「$yomiyasu:yomiyasu」、「yomiyasu で推敲して」など）と、スキルを使った日本語の推敲をはっきり頼んだときだけ使う。CLAUDE.md、AGENTS.md、カスタム指示などで yomiyasu を使うよう求められているときも、名前を出して頼まれたものとして扱う。名前を出さずに日本語の文章を書かせる依頼や、コード、設定、ドキュメントの更新では使わない。意味と条件を保ち、不自然な比喩、曖昧な主述関係、不要な装飾やコピー調を整える。

Sections in SKILL.md

用途と表記の扱い
1. 基本原則
最優先ルール: 意味の保持
文書の立場と文末
段落と文の論理構造（つながり）
主語と目的語の明確化
擬人化の解消
比喩動詞の具体化
セルフラベリングと否定対比の整理
情報の不増補（足さない）
情報が足りない場合の暫定文
内容に合わない大げさな名詞の整理
専門用語と名称の扱い
文長と読点の調整
案内用の見出し
コピー調の抑制

Key facts

Author: nanaism
License: MIT
Installs on skills.sh: 16,185 (Nov 2, 2026)
GitHub stars: 2,793 (Nov 2, 2026)
Last commit: Oct 31, 2026
What is inside: 43 files including SKILL.md: reference guides and word lists, 5 Python scripts, a Codex plugin file and licence files.
Skill version: 2.5.0 (SKILL.md metadata)
Language: Japanese (SKILL.md and output)
Tested by the author: Rewrites run with claude -p and codex exec on macOS; other clients and Windows are not verified

What it includes

Uses pasted text, your last answer or the only .md/.txt file in the folder
If you name the skill with no text, Claude looks at its previous answer, then at the folder, and asks if there are two or more files or none.
Try: “yomiyasu で draft.md を推敲して”
Files · Choose the text
Picks document type (13 kinds), reader level and writing stance
Reads the matching references/doc-types guide. Reader levels are expert, informed and general. It asks one question only when the answer changes the edit.
Read · Step 1: Context
Fixes metaphors, subjects, nominalization, decoration and copy-like tone
Follows the rules in SKILL.md section 1: keep meaning first, do not add facts, and turn personified or metaphorical verbs into concrete ones.
Write · Step 2: Rewrite
yomiyasu_check.py run runs the linter and a before/after diff
Saves the final draft as its own file, runs lint on it and diff against the original, and records the result.
Runs code · Step 3: Check
Looks for facts added or removed and changed sentence types
Claude reads the script candidates one by one, restores the original wording where meaning shifted, and may fix once and re-run.
Read · Step 4: Diff review
yomiyasu_check.py verify compares the final text to the record
Checks that the draft you receive is the one that was checked.
Runs code · Step 5: Final verify
Rewritten text, what changed, what was kept, questions for the writer, fact check
Sections for kept AI-like phrases and writer questions appear only when needed, with at most three questions.
Read · Output format

From the official docs

Permissions

Low risk

Yomiyasu runs its bundled Python scripts without asking and writes its rewritten draft and a record folder next to your files. Check the saved files before you share them.

What it can do

Read your data
Create and change things
Delete things
Read-only mode

Watch out for

Its scripts run without a prompt in that turn
SKILL.md allowed-tools pre-approves six python3, python and py -3 calls to its lint and check scripts. Read the script folder before you install if that matters to you. github.com
It saves files next to your draft
When Claude picks a file to polish, it saves the final draft in the same folder under a new name and keeps a .yomiyasu record folder. Add .yomiyasu to your .gitignore if you do not want it committed. github.com
Check runs keep copies of your draft
yomiyasu_check.py makes a temporary folder with a copy of the text while it checks and removes it afterwards; if it cannot, it prints a warning that a copy of the draft remains. Records go in the .yomiyasu state folder. The scripts contain no network library imports. github.com
An optional hook is not installed for you
yomiyasu_hook.py only runs if you paste its configuration into your Claude Code or Codex settings; its --print-config mode prints that configuration and does not edit any file. Once registered it can make Claude keep working, or stop, when the final draft does not match the check record. github.com

Technical details

Scopes	Runs yomiyasu_lint.py and yomiyasu_check.py with python3, python or py -3 Saves the final draft next to the original under a new name and leaves the original unchanged Writes check records to a state folder, by default .yomiyasu/ at the git root

Questions

What does the yomiyasu skill do?

It makes Claude revise AI-generated Japanese so it reads naturally. It fixes unclear subjects, odd metaphors and decoration, and it keeps the meaning and the writer's style.

How do I install yomiyasu?

Use the install box at the top of this page. The README lists npx skills add nanaism/yomiyasu as its recommended route, plus gh skill, openskills, a Claude Code plugin and a ZIP for the Claude web app.

How do I call it?

Name it, for example "/yomiyasu" or "yomiyasu で推敲して". SKILL.md says it does not run on ordinary requests to write Japanese. If you install it as a Claude Code plugin the name is yomiyasu:yomiyasu, and the README warns that plain "yomiyasu" can give "Unknown skill".

Does it work in English?

No. It is built for Japanese text. The README has an English page, but the rules and checks are for Japanese.

Does it work in Claude.ai, Codex or Cursor?

The README offers a ZIP for the Claude web app and says to use it in Claude Code, Codex and Cursor. The author says the rewrite was tested with claude -p and codex exec on macOS, and that the plugin route, Cursor, Claude.ai and Windows are not verified.

Is it safe to install?

It runs bundled Python scripts and saves a new draft file and a record folder in your project. Back up your original text, and read the scripts if you want to be sure.

Does it work with other Japanese proofreading skills?

SKILL.md warns that using it with other Japanese proofreading skills can make instructions clash, and suggests turning similar skills off if output looks wrong.

Information

updated Nov 2, 2026

Repository: nanaism/yomiyasu
Folder: skills/yomiyasu

nanaism/yomiyasu skills.sh

Sources

Docs, issue trackers and discussions this page is built from.

Show all 5

github.com · github.com
plugin.json · github.com
github.com · github.com
yomiyasu_check.py · github.com
yomiyasu_hook.py · github.com