AIToday
Large Language ModelsAI Coding AssistantsZenn AI/MLPublished: Oct 1, 2026, 10:00 JST

yomiyasu skill fixes AI-slop Japanese at the syntax level

yomiyasu skill fixes AI-slop Japanese at the syntax level

3 Key Points

  1. What happened

    Developer nanaism released 'yomiyasu', a rewriting skill for AI agents such as Claude Code, Codex and Cursor, installable with 'npx skills add nanaism/yomiyasu'. It restores sentence structure and turns metaphorical verbs into literal descriptions rather than banning specific words.

  2. Why it matters

    Rewriting who did what, and what actually happened, should make generated documents easier to follow.

  3. What to watch

    Whether the rules hold up outside the author's own 160-document corpus, which pairs LLM outputs with human-written documents. The one-command install and MIT license make that easy to test in a real team.

WHO IT HITSEngineers and technical writers who draft Japanese PR descriptions, specs and Slack announcements with AI agents stand to gain the most, since the skill targets the sentences those workflows produce. Teams that maintain their own documentation style guides could fork the rules, as it is published under the MIT license.

Not sure about something? Ask the AI

Questions and answers are published on this page.

Summaries like this, in your inbox every morning.

Context & Analysis

The skill grew out of a specific frustration with existing anti-AI-slop tools. Their instructions often used the very metaphorical verbs they told writers to avoid, and LLMs imitate the style of the prompt itself. They also told models to shorten the most important sentence to evade a sentence-length detector, which produced abrupt punchlines like 'Order is everything.' In response, the author built a corpus of 160 documents across eight practical genres and wrote a linter with lookaround regular expressions that ignore legitimate phrases such as 'grab the initiative' or 'melt ice'.

The design rests on three choices. First, instead of telling a model to replace words, the skill walks it through identifying the actor, reducing the event to physical facts, restoring subject-object-verb order, and flattening decorative formatting. Second, it forbids inserting short sentences just to vary rhythm and turns noun-heavy phrases back into verbs. Third, the skill's own instruction file was checked by the linter until it scored zero deductions, so the prompt itself serves as a model of the target style. A bundled Python script scores documents out of 100, deducting points for metaphorical verbs, decorative symbols, excessive bold and noun pile-ups.

Whether this approach travels beyond the author's own corpus is the open question. The boundary and human-written tests showed no false positives after the lookaround rewrite, but those 64 documents were assembled by the author. The test for teams is whether the rules survive contact with their own idioms, and the MIT license makes that easy to check. If it holds, the payoff is smaller: readers spend less time reconstructing who did what from context.

FAQ
How do I install yomiyasu?
You run 'npx skills add nanaism/yomiyasu' in an agent environment such as Claude Code, Codex CLI or Cursor. After that you can invoke it with '/yomiyasu', for example to rewrite a PR description.
How is yomiyasu different from simply banning AI-sounding words?
Banning words only makes the model swap 'hand feel' for 'actual state' or 'quietly effective' for 'exerts an effect', leaving the sentence skeleton unchanged. yomiyasu instead decomposes a sentence into meaning elements and reassembles it with a clear subject, object and verb, and it turns metaphorical verbs like 'break' or 'lean toward' into literal, concrete events.
What license is yomiyasu under?
It is released under the MIT license. You can modify the rules to match your own documentation policy, or fork it and add team-specific expressions and dictionaries.

AI news that matters for your work, delivered every morning.

Pick your industry and the AI tools you use, and get news related to your work every day.

Free · 30 seconds with Google · unsubscribe anytimeWhat is AIToday? →

Ask AI

Ask AI anything about this article. The AI reads this article, earlier AIToday articles, and Wikipedia, and cites its sources. Q&As are published on this page for other readers too.

Questions and answers are published on this page.

Related Articles

Next articleGoogle unveils Gemini 4 Argon, limits early access