CC for Biz
2026/11/16Claude Code
Skills活用AI活用

yomiyasu 3.0の変更点|2.xからの更新手順と注意

yomiyasu 3.0の変更点|2.xからの更新手順と注意

「yomiyasu が 3.0 になったらしいけれど、今の 2.x から上げて大丈夫か」「Codex で使っているが、呼び方が変わると聞いた」——AI が書いた日本語を直すスキルを毎日使っていると、版が上がるたびにこの迷いが出ます。

結論から言うと、yomiyasu 3.0 の変更点は「SKILL.md を46,311字から15,656字に書き直した互換性のない変更」と「Codex でのスキルの名前の変更(3.1.0)」の2つが中心です。更新の手順は入れ方ごとに1〜2行のコマンドで済みますが、Step の番号を CLAUDE.md で引いている人と、Codex にフォルダを写して入れた人は、書き換える所があります。

株式会社Fyveは、yomiyasu 2.5.0 を自社の作業フォルダに写して使っています。この記事では、公開されている変更履歴(CHANGELOG.md)と README を正にして、3.0.0〜3.1.0 で何が変わったか、入れ方ごとの更新手順、そして私たちが更新前に差分を確かめた結果と、入れた後に確かめていることをまとめます。

yomiyasu 3.0 の変更点を先に一覧で(3.0.0・3.0.1・3.1.0)

yomiyasu は、AI が書いた日本語の比喩・飾り・直訳調を、意味を変えずに直す推敲スキルです(MIT ライセンス・GitHub で公開)。3系は2日のあいだに3つの版が出ています。発表日は GitHub のリリースと CHANGELOG.md の日付です。

版

公開日

何が変わったか

影響を受ける人

3.0.0

2026年11月11日

SKILL.md を46,311字→15,656字に書き直し。Step の見出し・番号・中身を変更(互換性のない変更)。lint の直訳語の型を追加。語の一覧に flag-patterns.txt を追加。作業フォルダの外と点で始まるパスを読まない

全員。とくに CLAUDE.md や試験で Step の番号を引いている人、lint を CI で回している人

3.0.1

2026年11月11日

lint と diff の起動を速くしただけ。出力は 3.0.0 と1字も変わらない

lint・diff をモジュールとして読み込んでいる人だけ

3.1.0

2026年11月12日

スキルのフォルダから Codex 用のプラグインの設定(.codex-plugin/)を外した。推敲の手順は 3.0.1 と同じ

Codex にスキルのフォルダを写して入れている人(名前が yomiyasu:yomiyasu → yomiyasu)

推敲の中身が変わったのは 3.0.0 だけです。3.0.1 と 3.1.0 は、CHANGELOG に「推敲の手順(SKILL.md と references)は、SKILL.md のバージョンの行のほかは変えていません」と書かれています。2.x から上げるなら、3.1.0 まで一度に上げてかまいません。

yomiyasu 3.0.0・3.0.1・3.1.0の変更点と影響を受ける人の一覧

なぜ yomiyasu は 3.0 で作り直したのか|スキルなしとの比較で負けた測定

3.0.0 の CHANGELOG には、作り直したきっかけが数字つきで書かれています。ここを知っておくと、更新した後に何を期待してよいかが分かります。

外部の比較で「スキルなし」に23勝1敗で負けた

別の推敲スキルの作者が、12本の下書きで yomiyasu 2.4.0、別のスキル、スキルなしを比べた結果を公開しました。2つの AI に判定させたところ、読みやすさの1対1はスキルなしが yomiyasu に23勝1敗でした(24判定のうち23件は「小差」)。一方で、意味が変わったという指摘は yomiyasu が2件、スキルなしが7件で、12本の費用は yomiyasu が $10.29、スキルなしが $3.39 でした。

作者が 2.5.0 を同じ12本・同じ判定で測り直すと、Claude Opus 5.5 は12本すべてで 2.5.0 を3位にしています。さらに、スキルの効き目を素のエージェントや数行の指示と比べるよう勧める外部の記事を受けて、A(スキルなし)・B(5行の指示)・C(2.5.0)を比べると、読みやすさの1対1は A 対 C が22-2、B 対 C が22-2でした。

3.0.0 で何が良くなり、何が残ったか

作者はこの結果を受けて SKILL.md を約3分の1に短くし、問題が見つかった所に新しい決まりを5つ当てました。公開した 3.0.0 を同じ12本で2回測った数字は次のとおりです(CHANGELOG「確かめのあとの仕上げで測ったこと」より)。

測ったもの

A(スキルなし)

B(5行の指示)

3.0.0

12本の意味の指摘(重いもの)

14件(1件)・12件(0件)

44件(5件)・42件(2件)

3件(1件)・0件(0件)

読みやすさの平均順位(Claude Opus 5.5)

1.17・1.17

1.92・1.83

2.92・3.00

12本の費用

$2.60・$2.66

$2.80・$2.92

$7.77・$7.80

読み取れることは2つです。1つは、3.0.0 は意味を保つ点ではスキルなしより明らかに強いこと(14件と3件)。もう1つは、AI の判定による読みやすさでは、3.0.0 でもスキルなしにほぼ負けていることです。費用はスキルなしの約3倍かかります。

費用は 2.5.0 の $10.16 より2割あまり下がっていますが、「3.0 に上げれば文章が読みやすくなる」とは CHANGELOG のどこにも書かれていません。私たちもこの記事でそうは言いません。作者が負けた測定を自分で公開し、それを材料に作り直した、という経緯そのものが、推敲のスキルを使う側にとっての手本だと考えています(後半の「入れた後に確かめること」で扱います)。

この記事を読んでいるあなたへ無料プレゼントClaude Codeを「素のまま」使うな設定で差がつく——CLAUDE.md・権限・スキルの実物を公開(全24ページ)
そのまま書き換えて使えるCLAUDE.mdの型お金と送信をAIに触らせない「3段階の柵」1回教えたら何度でも動く、手順書のコピペ雛形
中身のプレビューを見る ↓登録すると、過去の特典もまとめて受け取れます(PDF 23点・合計550ページ + すぐ使えるzip素材 3点)

yomiyasu 3.0.0 の互換性のない変更|SKILL.md の番号と外した決まり

3.0.0 はメジャーバージョンで、CHANGELOG に「互換性のない変更」の節があります。更新の前に、自分の環境に当たるものがないかを見てください。

Step の見出しと番号が変わった

  • 1章(基本原則)は節をいくつかまとめて名前を変えました。例: 「擬人化の解消」と「比喩動詞の具体化」は「比喩動詞の具体化と擬人化の解消」に
  • 2章(実行手順)は Step 1〜4 の見出しと Step 1〜5 の中身、Step 2 の項目の番号を変えました。2.5.0 の Step 2 の手順1〜15はなくなりました
  • 13の文書の種類は表をやめて文で並べ、種類を決めたら references/doc-types/ のその種類のファイルを必ず読む形になりました

CLAUDE.md や AGENTS.md に「yomiyasu の Step 2 の手順9に従って」のように番号で書いている場合は、3.0 では指す先がなくなります。番号ではなく、やってほしいこと(例: 「意味を変えずに推敲して」)で書き直してください。

字数のために外した 2.5.0 の決まり

15,000字前後に収めるため、2.5.0 の決まりのうちいくつかを SKILL.md から外しています。CHANGELOG に挙がっている主なものは次のとおりです。

  • 比喩動詞を言い換えられないときに残す決まり
  • 小説・随筆・宣伝文の守り(種類を決めないとき)と、小説・随筆のダッシュ
  • 漢語の名詞を同じ意味の別の漢語に替えるだけで済ませない決まり
  • 種類とは別に分野を決めて references/domains/ を読む手順
  • 平均の文の長さと読点の数の目安

CHANGELOG には「外した決まりに当たる文は、3.0.0 では 2.5.0 と同じようには直りません」とあります。全部の一覧は docs/limitations.md の「3.0.0 の SKILL.md で測ったこと」にあります。2.5.0 のこの決まりに頼っていた文書の種類(小説・随筆など)があるなら、更新の前に一覧を読んでおくと安全です。

lint と語の一覧で変わること

付属の lint(表現と書式の検査)は、コマンドや JSON の形は 2.5.0 と同じですが、当たり方が一部変わります。

変更

中身

更新後に起きること

直訳語(calque・info)

型4に「枝」「題」「罫」、型5(英語の術語に当てた2字以上の名詞。背景実行・根因・見張り・台本など)を追加

info なので点数や --strict には入らない

前提の比喩(metaphor_verb・warn)

「前提が崩れています」「基盤も崩れ」などの形にも当たる

こうした文がある文書では点数が下がり、--strict と --fail-on warn の終了コードが1になる

flag-patterns.txt(新設・任意)

語の一覧(.yomiyasu-words/)に、1行に「名前<TAB>正規表現」を書ける。500個まで

置いたときだけ JSON にキーが2つ増える

flag.txt の TAB

「使わない語<TAB>使う語」と書ける。使う語は80字まで

今まで TAB ごと1語で読んでいた行の読み方が変わる。3列の行は終了コード2

CI で --fail-on warn を使っている人は、「前提が崩れる」系の文がある文書で CI が落ち始める可能性があります。更新した日に一度、手元で lint を流して件数を見ておくのが無難です。

作業フォルダの外と「.env」のようなパスを読まなくなった

3.0.0 から、lint・diff・check はコマンドラインで渡されたファイルが作業フォルダの外にあるときと、道筋に点で始まる部分(.env、.git/config など)があるときは、読まずに終了コード2で止まります。推敲する文書に紛れ込んだ指示で、確認なしに動く検査が鍵のファイルを読んで中身を出さないようにするためです。

作業フォルダの外のファイルを渡していたスクリプトや CI は止まります。ファイルのあるフォルダで実行するか、標準入力(lint と diff は -)で渡す形に直してください。

yomiyasu 3.0.1 と 3.1.0 で変わったこと

3.0.1:lint と diff の起動が速くなった

3.0.1 は、組み込みの正規表現を読み込みのたびに組むのをやめ、初めて使うときに組むようにした版です。CHANGELOG の計測では、1組の check run --json が Python 3.14.5 で493ミリ秒→352ミリ秒になっています。出力は 3.0.0 と1字も変わりません。

影響があるのは、lint や diff を Python のモジュールとして読み込み、re.sub(EMOJI_PATTERN, …) のように re の関数へそのまま渡している人だけです。この書き方は TypeError になるので、EMOJI_PATTERN.sub(…) の形に直します。

3.1.0:Codex 用のプラグインの設定を外した

3.1.0 は、パッケージマネージャーの apm がスキルのフォルダをプロジェクトに入れられなかった原因をなくすため、skills/yomiyasu/.codex-plugin/plugin.json を消した版です。推敲の手順と lint・diff・check の出力は 3.0.1 と同じです。この変更で、Codex にフォルダを写して入れている人だけ、スキルの名前が変わります(下の「Codex で使っている人だけ」の節)。

yomiyasu を 2.x から 3.x へ更新する手順(入れ方別)

手順0:今の版を確かめる

入れたスキルのフォルダにある SKILL.md の先頭(YAML)の metadata.version を見ます。私たちの環境では version: "2.5.0" でした。どの入れ方で入れたか覚えていない場合は、スキルのフォルダの場所で見分けます(プラグインなら Claude Code のプラグインの一覧に出ます)。

手順1:入れ方ごとに更新する

コマンドは README の「インストール」の節のとおりです。

入れ方

更新のコマンド

注意

npx skills add(README の推奨)

npx skills update yomiyasu

-g で入れたときは -g も付ける

gh skill install

gh skill update yomiyasu

--force で上から入れ直すと古い設定が残る(下記)

npx openskills install

npx openskills update yomiyasu → npx openskills sync

sync は AGENTS.md の <skills_system> の中を書き直す

Claude Code のプラグイン

claude plugin marketplace update yomiyasu → claude plugin update yomiyasu@yomiyasu

反映には Claude Code の再起動が必要

ZIP(Claude.ai の Web 版など)

最新の yomiyasu.zip を落として登録し直す

リポジトリ全体の ZIP ではなく登録専用の ZIP を使う

フォルダを写した形(Codex Cloud など)

README の「6.」のコマンドをもう一度実行

前のフォルダは .agents/yomiyasu.bak-日付-時刻/ に移される

gh skill install --force で上から重ねると、古い .codex-plugin/ が残ります。CHANGELOG によると、作者が gh 2.103.3 で 3.0.1 のフォルダの上から 3.1.0 を入れたところ、.codex-plugin/plugin.json が消えずに残りました。残ったフォルダは手で消すか、スキルのフォルダを消してから入れ直してください。

手順2:検査の記録を取り直す

check(検査をまとめて実行して記録を残すツール)を使っている人は、2.5.0 で残した記録を 3.x の verify で照らすと tool_changed になります。検査のスクリプトが変わったためで、壊れたわけではありません。run をもう一度実行すれば直ります。3.0.0→3.0.1→3.1.0 と1つずつ上げた場合も、上げるたびに同じことが起きます。

手順3:Step の番号を引いている所を直す

前の節のとおり、SKILL.md の節の名前や Step の項目の番号を CLAUDE.md・AGENTS.md・自分の文書や試験で引いていれば、3.0 の SKILL.md に合わせて書き直します。CHANGELOG はこれを「更新するときの注意」の最後に挙げています。

yomiyasuを2.xから3.xへ上げるときの確かめ順(版の確認・更新・記録の取り直し・Codexの名前)

Codex で使っている人だけ|スキルの名前が yomiyasu に変わる

3.1.0 の変更で、Codex にスキルのフォルダを写して入れる形(README の「6.」、npx skills add、gh skill install)では、スキルの名前が yomiyasu:yomiyasu から yomiyasu に変わります。

どちらの名前になっているかの見分け方

スキルのフォルダ(.agents/skills/yomiyasu など)に .codex-plugin/ があれば yomiyasu:yomiyasu、なければ yomiyasu です。3.0.1 までを写したまま使い続けるなら、何も変える必要はありません。

名前が変わったら書き換える3か所

  1. 依頼の文の $yomiyasu:yomiyasu を $yomiyasu にする。Codex がスキルの指示を自動で差し込むのは、$ に続く名前が一覧の名前と1字ずつ同じときだけです
  2. AGENTS.md に足した「常に yomiyasu スキルで推敲してください」の1行の名前を yomiyasu にする
  3. Codex の設定でスキルを名前で指定しているなら、config.toml の [[skills.config]] の name と、environments.toml の skills の required を yomiyasu にする

作者の測定(codex-cli 0.164.0、codex exec)では、名前が yomiyasu の形に古い書き方で頼んだ8回も、どれもスキルを読みました。ただしこれは Codex が自動で差し込んだのではなく、モデルが自分で SKILL.md を読んだ結果です。読むかどうかはモデルしだいなので、CHANGELOG は書き換えを勧めています。

Claude Code では名前は変わらない

Claude Code では、プラグインで入れた形は yomiyasu:yomiyasu、npx skills add や gh skill install で入れた形は yomiyasu のままです。プラグインで入れた人が yomiyasu とだけ書くと「Unknown skill」になる点は 3.x でも同じなので、名前で呼ぶときはスラッシュの補完に出る名前を使ってください。

私たちの更新の判断|比べるだけのスクリプトで差分を見た

私たちは yomiyasu を、GitHub の skills/yomiyasu/ をそのまま作業フォルダに写す形で使っています。取り込んだのは 2.5.0(2026年11月9日)で、中身は手で直さず、取り込み元と版を書いたメモのファイルだけを足しています。

更新には、自作の小さなシェルスクリプトを使っています。最新版を一時フォルダに取り出して比べるだけのモードと、上書きするモードの2つを持ち、ふだんは比べるだけを先に流します。2026年11月17日に比べるだけのモードを流した結果は次のとおりでした。

項目

結果

今の版 → 最新版

2.5.0 → 3.1.0

SKILL.md の字数(Python で数えた)

手元 46,311字 → 最新 15,656字

中身が違うファイル

SKILL.md 1本、references 15本、scripts 5本(lint・diff・check・フック・共通の部品)

手元にだけあるもの

.codex-plugin/(3.1.0 で外されたもの)

最新にだけあるもの

assets/(画像1枚)

この結果から、2つのことを決めました。

1つ目は、上書きは「入れ替え」で行うことです。私たちのスクリプトは上書きのときに、取り込み元にないファイルを消す形でフォルダを入れ替えます。そのため .codex-plugin/ は残りません。上の gh skill install --force のように「重ねる」形の更新だと、ここが残ります。自分で写す形を使っている人は、コピーではなく入れ替えになっているかを一度確かめてください。

2つ目は、scripts が5本とも変わっているので、上書きした後に読んでから使うことです。私たちは 2.5.0 を取り込んだときに、付属のスクリプトがネットにつながず、ほかの場所を消さないことを読んで確かめました。3.0.0 では pathlib への書き換えや「作業フォルダの外を読まない」判定が入っており、変更の量が多いので、同じ確かめをやり直してから使います。

なお、私たちは 2026年11月17日の時点で 3.x を手元ではまだ動かしていません。この記事の 3.x の振る舞いは、すべて CHANGELOG と README に書かれている作者の測定と説明です。

yomiyasu を入れた後に確かめること|スキルなしと並べ、自分の文で誤検知を数える

3.0.0 の経緯から学べるのは、決まりを多く並べた推敲のスキルほど、素の状態と比べないと効いているか分からないということです。これは yomiyasu に限りません。私たちも自社の文章に、AI 臭(AI の文章に特有の言い回し)を拾う独自の辞書を当てていて、同じ考え方で運用しています。

私たちの AI 臭の辞書での測り方

  • 辞書(50本)に足すのは、「AI の初稿に出て、書き手本人の実文には0回」の語だけ
  • 書き手本人が実際に使っている語は外す。2026年9月に3語(「不可欠」「解説していきます」「かで見る」)を外した
  • 2026年9月5日時点で、書き手本人の実文190本に当てて誤検知は0本。却下した原稿15本のうち、直訳・定型に当たる5本は全部拾えた
  • 辞書は書かせる前に渡さない。生成の前に渡すと、禁止した語の代わりに別の型が出ることを確かめている

yomiyasu からは「意味の4点(主張・比重・言い切りの強さ・文の働き)を変えない」「資料にないことを足さない」の2つの考え方を借りています。一方、付属の lint は使っていません。2026年10月1日に 2.x の lint を当てると、本人の実文12本のうち4本、AI の原稿17本のうち5本を検出し、本人の文と AI の文を見分けられなかったためです。3.0.0 で lint の判定は変わっているので、この数字は 3.x には当てはまりません。更新した後に測り直す予定です。

推敲のスキルを入れたら行う3つの確かめ

  1. スキルなしと並べる:同じ原稿を、スキルを使わずに「読みやすく直して」とだけ頼んだ結果と、スキルを使った結果を並べて読みます。作者の測定のように、意味が変わった所と、読みやすさの差を分けて見ます
  2. 自分が書いた文を通して、直されたくない所を何か所直されたか数える:自分の文はスキルにとって「直す必要のない文」のはずです。ここで多く直されるなら、自分の文体とスキルの決まりが合っていません
  3. どちらかで負けたら、借りる決まりを絞る:スキル全体を使わず、効いている決まりだけを自分の指示や CLAUDE.md に移す、という選択肢もあります

数字を残すときは、測った日と対象(何本・誰の文か)を必ず添えてください。版が上がると同じ数字が再現しないことがあり、日付がないと前の数字と比べられません。

yomiyasu 3.0 に上げる前に気をつけること

  • yomiyasu-mini と yomiyasu-pocket は別の版:ファイルの数や大きさに上限がある環境向けの mini と、指示欄に貼る pocket は、どちらも本体 3.0.0 から作った 2.0.0 です。本体の 3.0.1 と 3.1.0 は推敲の手順を変えていないので、この2つは更新されていません
  • 確かめられている範囲:読みやすさと意味を測ったのは、macOS の Claude Code の claude -p でプラグインを読み込んだときだけです。対話の画面、Windows、npx skills add などのほかの入れ方では、作者は 3.0.0 を確かめていないと書いています
  • 「ではなく、」を作ることがある:2文の否定対比を1文にまとめるとき、決まりに反して原文にない「ではなく、」を作ることがあります(3.0.0 の12本で4か所と3か所)。作者が限界として公開しているものです
  • ほかの日本語校正スキルとの併用:README は、類似のスキルと一緒に使うと指示が食い違う場合があるので、出力が乱れたら一時的に無効にするよう書いています
  • スキルのフォルダの中を書き換えない:更新でフォルダの中身が入れ替わる入れ方では、書き換えた所が残りません。プロジェクトに合わせた語は、フォルダの外の .yomiyasu-words/ や CLAUDE.md・AGENTS.md に書きます

あわせて読みたい記事

yomiyasu の入れ方と頼み方、架空のお知らせ文で試した結果は、こちらの記事にまとめています。

yomiyasuとは|AIの日本語を直すスキルの入れ方と試した結果
Claude Codeyomiyasuとは|AIの日本語を直すスキルの入れ方と試した結果

yomiyasu と比べられた別の推敲スキル natural-japanese の使い方は、こちらです。

natural-japaneseとは|AIの日本語を直す使い方
Claude Codenatural-japaneseとは|AIの日本語を直す使い方

Codex で AGENTS.md に1行を足すときの書き方は、こちらで解説しています。

AGENTS.mdの書き方|Codex設定ファイル実践ガイド

直訳語(カルク)がなぜ AI っぽく見えるのかは、こちらの記事で扱っています。

AIっぽい文章の正体は英語の直訳|禁止語リストが効かない理由

まとめ|yomiyasu 3.0 に更新する前のチェックリスト

yomiyasu 3.0 の変更点は、SKILL.md を約3分の1に書き直した 3.0.0 と、Codex での名前が変わる 3.1.0 の2つが中心です。2.x から上げるなら 3.1.0 まで一度に上げ、次の順に確かめてください。

  • SKILL.md の metadata.version で今の版を確かめた
  • CLAUDE.md・AGENTS.md・試験で Step の番号や節の名前を引いていないか見た
  • 外した 2.5.0 の決まり(docs/limitations.md)に、頼っていたものがないか見た
  • 入れ方に合ったコマンドで更新した(--force で重ねた場合は .codex-plugin/ を消した)
  • check を使っているなら run を取り直した
  • lint を CI で回しているなら、--fail-on warn の結果と、作業フォルダの外のファイルを渡していないかを見た
  • Codex で使っているなら、名前(yomiyasu か yomiyasu:yomiyasu)を確かめ、3か所を書き換えた
  • 入れた後に、スキルなしとの比較と、自分の文での誤検知を数えた

推敲のスキルは、入れただけでは効いているかが分かりません。作者自身が負けた測定を公開して作り直した 3.0 は、測ってから使うことの手本です。株式会社Fyveも、更新の後に自分たちの文で測り直してから使っていきます。

この記事を読んでいるあなたへ無料プレゼント

Claude Codeを「素のまま」使うな

設定で差がつく——CLAUDE.md・権限・スキルの実物を公開(全24ページ)

素のClaude Codeは"優秀な新入社員"。仕事を教えるほど、自分専用になります。覚えさせる4点セット——会社の説明書(CLAUDE.md)・権限の柵・手順書(スキル)・フォルダの地図——を、1人会社の実運用からコピペで使える型つきで公開します。

  • そのまま書き換えて使えるCLAUDE.mdの型
  • お金と送信をAIに触らせない「3段階の柵」
  • 1回教えたら何度でも動く、手順書のコピペ雛形
  • AIが迷子にならないフォルダ構造の3原則

メールアドレス登録で他にも様々な資料を閲覧できます

Claudeのプランを「上げる」前に読む本AIっぽくない画像を生成するためのプロンプトギャラリー10選「Muse」の便利な使い方 TOP30「Fable 5.2」vs「Opus 5.5」徹底比較「GPT-6.1 Terra」を、実務で比べてみた。仕事でAIを使う人が「絶対に」知っておくべき Claude Codeスキル TOP10「Sonnet 5.5」を、実務で比べてみた。Codexを使い始める前に、「絶対に」見直してほしい5つのこと「Opus 5.5」を、実務で比べてみた。+14

PDF 23点・合計550ページ + すぐ使えるzip素材 3点

どれも登録後の受け取りページから、まとめてダウンロードできます。

毎週配信の無料ニュースレター「AIネイティブ超研究」の購読特典です。メール登録後すぐ、受け取りページのご案内が届きます。そこにはこの資料に加えて、過去の特典もすべてまとめて置いてあります。あわせて、AI活用に関するお知らせやお役に立てそうなご案内をお送りすることがあります。解除はいつでも1クリック。

← 記事一覧に戻る

御社の業務に合わせたClaude Code導入支援

「AIツールを導入したが、現場で使われない」を終わらせる。
業務課題のヒアリングから設計、ハンズオン実践、運用定着まで一貫して支援します。

無料AI活用診断を受ける料金とサービス一覧を見る →
© 2025 Fyve Inc. All rights reserved.