nanaism/yomiyasu
AI生成の日本語を自然な日本語へ推敲するAgent Skill / Agent Skill for Refining AI-Generated Japanese into Natural Japanese
Older snapshot: check the original source for current information.
From the publisher
README & documentation
Source previewRead the project’s overview, installation instructions and usage examples. The original README is the source of truth.
[](./LICENSE) [](https://github.com/nanaism/yomiyasu/releases) English 『yomiyasu(よみやす)』はAIが生成した日本語の不自然な比喩、曖昧な主述関係、不要な装飾を直し、読みやすい文章に整えるスキルです。 主に技術記事、設計書・仕様書、PR説明文、社内レポートなどの実務的な文章を対象として設計されています。 Claude Code、Codex、CursorをはじめとするAIコーディング環境に読み込ませて使用してください。本体を入れられない環境のために、本体から作った yomiyasu-mini と yomiyasu-pocket も公開しています(本体を入れられない環境では)。 開発の背景、AI生成文の読みにくさ、コーパスを使った検証については、次の解説記事で紹介しています。 Built with curiosity at ALGO ARTIS [](https://www.algo-artis.com/) ALGO ARTISについて 文章を生成するAIは日常的な道具となりました。 一方で、AIで生成された文章には独特のクセが残りやすく、そのままでは実務や技術発信に使いにくい場面があります。 AIが書いた日本語には、たとえば次のような形がよく出ます。 誰が何をどうするのかが省略されたまま、概念や道具が比喩的な動詞(壊れる、倒す、効くなど)と結びつき、読み手が文脈を補って読む必要があります。 太字や箇条書きが増える一方で、手順やコードの仕組みといった中身は抽象的に書かれ、文章の量に比べて実際の情報が少なくなります。 短い主題のすぐあとに間を作るだけの読点を置く、箇条書きの先頭に太字のラベルとコロンを付ける、否定と肯定を2文に分けて対比する、といった形です。 こうした所を元の意味を保ったまま直すために、yomiyasu は指示書(SKILL.md)と、直す前と後を比べて意味が変わる恐れのある所を出す検査のツールをまとめています。 元の意味を保つことを最優先にして、読み違えやすい箇所や、文の関係を追うのに負担がかかる箇所を直します。自然に読める部分は残すよう SKILL.md に書いています。 主語と述語、修飾語と掛かる先、指示語と指す対象を対応づけます。条件・例外・否定・並列・数量・順序も、書き直す前後で同じように追えるか確かめます。主体や対象を補うのは、原文や提供文脈から確定できる範囲に限ります。 文ごとに評価・説明・依頼・予定・感想の働きを区別し、働きに合わない文末だけを直します。完了した変更作業、現在の動作や方針、今後の予定を時制と役割に合わせて書き分け、語尾を散らすこと自体を目的にしません。常体・敬体は変更の指定がなければ保ち、技術記事という分野だけを理由に敬体へ変えません。 道具や概念に感情や意志を持たせた表現を直します。道具やシステムの客観的な動作を述べる非生物主語は残します。 壊れる、倒す、効く、溶かすなどは、何がどう変わったかを書くか、ふだんの言い方に直します。元の含みと意味の広さは保ち、原文より強い確度の語は足しません。慣用句は残します。 否定対比(AではなくB)を肯定文にするのは、Aを外しても主張が変わらないときだけです。誤解を正す否定は残し、否定と肯定を2文に分けた形は1文にまとめます。理由・対比・結論を示す前置きは残します。…
Read the full README ↗ · Preview checked 2026-11-14T16:25:59.859Z
Inside the original README — Document outline
Headings are captured from the source. Links open the publisher’s document, not a locally hosted copy.
Links from the README
References supplied by the publisher, not independently verified endorsements. Check the destination before downloading files or entering credentials.
Documentation belongs to its respective authors. Reported project/model license: MIT. A listing is not a grant of reuse or training rights. Confirm the document’s own terms at the source.
What this repository does
AI生成の日本語を自然な日本語へ推敲するAgent Skill / Agent Skill for Refining AI-Generated Japanese into Natural Japanese
Repository facts
- Owner
- nanaism
- Primary language
- Python
- Stars
- 2,741
- Forks
- 71
- Open issues + pull requests
- 0
- License
- MIT
- Archived
- No
- Default branch
- main
- Created
- 2026-09-30T11:49:32.000Z
- Last push
- 2026-10-30T02:21:45.000Z
Topics and intended use
Owner-supplied topics: agent-skills, ai-writing, antigravity, claude-code, codex, cursor, gemini, japanese, linter, llm, nlp, writing, writing-assistant, writing-tool
Review the README for scope, installation, examples and limitations. We do not run repository code or certify it.
Evaluate before installing
Review licensing and dependencies, inspect recent commits and unresolved issues, and test in an isolated environment before production use. Stars and forks alone cannot answer these questions.
Source and freshness
Source: GitHub. Metadata observed 2026-10-30T12:17:28.121Z. Daily imports are snapshots, not real-time monitoring.
Popularity and source listings do not establish security, suitability, licensing rights or benchmark performance.
Related repositories
EbookFoundation/free-programming-books
donnemartin/system-design-primer