yomiyasu

AI生成の日本語を自然な日本語へ推敲するAgent Skill / Agent Skill for Refining AI-Generated Japanese into Natural Japanese

What is yomiyasu?

AI生成の日本語を自然な日本語へ推敲するAgent Skill / Agent Skill for Refining AI-Generated Japanese into Natural Japanese

Overview of yomiyasu

What it is

yomiyasu (よみやす) is an agent skill for refining AI-generated Japanese into natural, readable Japanese. It corrects unnatural metaphors, ambiguous subject-predicate relationships, and unnecessary decorations in AI-generated text. The skill is designed primarily for practical documents such as technical articles, design documents, specifications, PR descriptions, and internal reports. It is intended to be loaded into AI coding environments including Claude Code, Codex, and Cursor. For environments where the full skill cannot be installed, reduced versions called yomiyasu-mini and yomiyasu-pocket are also available. The project was developed by ALGO ARTIS Co., Ltd., a startup that works on mathematical modeling and heuristic optimization algorithms for social infrastructure.

Key features

  • Corrects unnatural metaphors and figurative expressions (e.g., 壊れる, 倒す, 効く, 溶かす) into plain language while preserving the original meaning and nuance.
  • Adjusts subject-predicate relationships, modifiers, conditions, and references to ensure clarity without adding information not present in the original text.
  • Preserves the function and style of each sentence (evaluation, explanation, request, plan, impression) and only fixes endings that do not match the intended function.
  • Removes unnecessary commas that only create pauses, while keeping commas that prevent misreading or separate parallel items.
  • Removes bold text, decorative symbols (emoji, dashes) except in specific document types like emails, chats, or advertisements where the writer's emotion is expressed.
  • Does not add inferred actors, causes, conditions, numbers, examples, or technical terms that are not present in the original text.
  • Provides a tool to check for places where meaning might change between the original and the refined version.

Use cases

  • Refining AI-generated technical articles, design documents, and specifications to make them more readable for human readers.
  • Polishing PR descriptions and internal reports that were initially drafted by AI.
  • Improving the clarity of AI-generated text in business and technical communication without altering the original meaning.
  • Checking for potential meaning changes after refinement using the included inspection tool.

Getting started

See the repository README for installation and usage instructions.

License and pricing

The project is licensed under the MIT License. It is open source and free to use.

Based on the project's public README and repository metadata.

Add this badge to your README

Featured on YunoDB Badge styles & help

Maintain this project? Show that it is featured on YunoDB.

Markdown[![Featured on YunoDB](https://yunodb.com/badge/nanaismyomiyasu.svg)](https://yunodb.com/tools/nanaismyomiyasu?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/nanaismyomiyasu?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/nanaismyomiyasu.svg" alt="Featured on YunoDB" height="20"></a>